IKeyStore::GetKeyValue 方法 (dbgmodel.h)
GetKeyValue 方法是客户端为了在元数据存储中查找特定键的值而转到的第一种方法。 如果由 key 参数指定的键存在于存储 (或其父存储) 中,则将返回该键的值以及与它关联的任何元数据。 如果键的值是一个属性访问器, (装箱到 IModelObject) 中的 IModelPropertyAccessor,则 GetKeyValue 和返回的属性的基础值将自动调用属性访问器的 GetValue 方法。
语法
HRESULT GetKeyValue(
PCWSTR key,
_COM_Errorptr_opt_ IModelObject **object,
IKeyStore **metadata
);
参数
key
要为其返回值的键的名称。
object
此处将返回键的值。 如果键的值为属性访问器,则会在属性访问器上调用 GetValue 方法,并在此处返回该基础值。
metadata
可以选择在此处返回与密钥关联的任何元数据。 二级元数据目前没有用途。 因此,通常应将此参数指定为 null。
返回值
此方法返回指示成功或失败的 HRESULT。
注解
代码示例
ComPtr<IKeyStore> spMetadata; /* get a metadata store */
ComPtr<IModelObject> spRadix;
if (SUCCEEDED(spMetadata->GetKeyValue(L"PreferredRadix", &spRadix, nullptr)))
{
// spRadix has the preferred display radix. Use GetIntrinsicValueAs to unbox.
}
要求
要求 | 值 |
---|---|
Header | dbgmodel.h |