iModelObject：：GetKey 方法 (dbgmodel.h)

  • 项目

GetKey 方法将按名称获取 (的值以及与) 给定键关联的元数据。 大多数客户端应改用 GetKeyValue 方法。 如果键是属性访问器，则调用此方法将返回属性访问器 (IModelPropertyAccessor 接口) 装箱到 IModelObject 中。 与 GetKeyValue 不同，此方法不会通过调用 GetValue 方法自动解析密钥的基础值。 该责任是调用方的责任。

语法

HRESULT GetKey(
  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> spIdKey;
if (SUCCEEDED(spProcess->GetKey(L"Id", &spIdKey, nullptr)))
{
    // Unlike GetKeyValue(), spIdKey may contain a value or it may be a 
    // *property* that needs to be fetched.  Check!
    ModelObjectKind kind;
    if (SUCCEEDED(spIdKey->GetKind(&kind)))
    {
        if (kind == ObjectPropertyAccessor)
        {
            VARIANT vtProp; 
            if (SUCCEEDED(spIdKey->GetIntrinsicValue(&vtProp)))
            {
                // There is an *in-process* guarantee because of 
                // ObjectPropertyAccessor that the IUnknown is an IModelPropertyAccessor
                IModelPropertyAccessor *pPropertyAccessor = 
                    static_cast<IModelPropertyAccessor *>(vtProp.punkVal);

                // Fetch the value underneath the property accessor.  GetKeyValue 
                // would have done this for us.
                ComPtr<IModelObject> spId;
                if (SUCCEEDED(pPropertyAccessor->GetValue(L"Id", spProcess.Get(), &spId)))
                {
                    // spId now contains the value of the id.  Unbox with GetIntrinsicValueAs.
                }

                VariantClear(&vtProp);
            }
        }
        else
        {
            // spIdKey contains the value.  Unbox with GetIntrinsicValueAs.
        }
    }
}

要求

要求 值
Header dbgmodel.h

另请参阅

IModelObject 接口