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 |