Метод 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.
}
Требования
| Требование | Значение |
|---|---|
| Заголовок | dbgmodel.h |