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.
}

要求

要求
Header dbgmodel.h

另请参阅

IModelObject 接口