IKeyStore：：GetKeyValue 方法 (dbgmodel.h)

GetKeyValue 方法是用戶端將移至的第一個方法，以便尋找元數據存放區內特定索引鍵的值。 如果索引鍵自變數指定的索引鍵存在於存放區 (或父存放區) ，則會傳回該索引鍵的值及其相關聯的任何元數據。 如果索引鍵的值是屬性存取子 (IModelPropertyAccessor boxed 到 IModelObject) ，則 GetKeyValue 屬性存取子的 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 介面