Метод IModelObject::GetKeyValue (dbgmodel.h)

Метод GetKeyValue является первым методом, к которым клиент будет обращаться, чтобы получить значение (и метаданные, связанные с) заданным ключом по имени. Если ключ является методом доступа к свойствам, то это значение в качестве IModelObject, который является IModelPropertyAccessor, метод GetKeyValue автоматически вызовет метод GetValue для получения фактического значения.

Синтаксис

HRESULT GetKeyValue(
  PCWSTR                          key,
  _COM_Errorptr_opt_ IModelObject **object,
  IKeyStore                       **metadata
);

Параметры

key

Имя ключа для получения значения.

object

Значение ключа будет возвращено в этом аргументе. В некоторых случаях ошибки расширенные сведения об ошибке могут быть переданы в этом аргументе, даже если метод возвращает ошибку HRESULT.

metadata

Хранилище метаданных, связанное с этим ключом, при необходимости будет возвращено в этом аргументе.

Возвращаемое значение

Этот метод возвращает HRESULT, указывающий на успех или сбой. Возвращаемые значения E_BOUNDS (или E_NOT_SET в некоторых случаях) указывают, что ключ не найден.

Замечания

Пример кода

ComPtr<IModelObject> spProcess; /* get a process object */

ComPtr<IModelObject> spProcId;
if (SUCCEEDED(spProcess->GetKeyValue(L"Id", &spProcId, nullptr)))
{
    // spProcId has a boxed process id.  Use GetIntrinsicValueAs to unbox it.
}

Требования

См. также

интерфейс IModelObject