IKeyStore::GetKeyValue 方法 (dbgmodel.h)

GetKeyValue 方法是客户端将转到的第一种方法,以便在元数据存储中查找特定键的值。 如果由密钥参数指定的键存在于存储区(或它是父存储),则返回该键的值及其关联的任何元数据。 如果键的值是属性访问器(IModelPropertyAccessor 装箱到 IModelObject),则属性访问器的 GetValue 方法将由 GetKeyValue 和返回的属性的基础值自动调用。

语法

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

要求

要求 价值
标头 dbgmodel.h

另请参阅

IKeyStore 接口