(dbgmodel.h) 的 IModelObject：：GetKeyValue 方法

GetKeyValue 方法是用戶端將轉換的第一個方法，以便依名稱取得 (和與指定索引鍵) 相關聯的元數據。 如果索引鍵是屬性存取子，也就是其值為 IModelObject ，它是Boxed 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

另請參閱

IModelObject 介面