(dbgmodel.h) IKeyStore：：SetKey 方法

SetKey 方法類似於 IModelObject 上的 SetKey 方法。 這是唯一能夠建立密鑰，並將元數據與金鑰存放區內建立關聯的方法。

語法

HRESULT SetKey(
  PCWSTR       key,
  IModelObject *object,
  IKeyStore    *metadata
);

參數

key

要為其建立或設定值的索引鍵名稱。

object

索引鍵的值。

metadata

要與此索引鍵相關聯的選擇性元數據。 第二層元數據沒有現用。 因此，這個自變數通常應該指定為 null。

傳回值

這個方法會傳回表示成功或失敗的 HRESULT。

備註

程式碼範例

ComPtr<IDataModelManager> spManager; /* get the data model manager */
ComPtr<IKeyStore> spMetadata;        /* get or create a metadata store */

ComPtr<IModelObject> sp16;
VARIANT vt16;
vt16.vt = VT_UI4;
vt16.ulVal = 16;
if (SUCCEEDED(spManager->CreateIntrinsicObject(ObjectIntrinsic, &vt16, &sp16)))
{
    if (SUCCEEDED(spMetadata->SetKey(L"PreferredRadix", sp16.Get(), nullptr)))
    {
        // The 'PreferredRadix' key has been set to 16 (even if it did 
        // not exist).  If this metadata store is passed to something like
        // IStringDisplayableConcept::ToDisplayString, the conversion of numbers 
        // will happen in hexadecimal instead of the default radix.
    }
}

規格需求

需求	值
標頭	dbgmodel.h

另請參閱

IKeyStore 介面