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 |