IKeyStore：：SetKeyValue 方法 (dbgmodel.h)

SetKeyValue 方法類似於 IModelObject 上的 SetKeyValue 方法。 此方法無法在元數據存放區內建立新的索引鍵。 如果索引鍵自變數所指示的現有索引鍵，其值將會設定為所指示。 如果索引鍵是屬性存取子，則會在屬性存取子上呼叫 SetValue 方法，以設定基礎值。 請注意，元數據通常是靜態的一旦建立。 在元數據金鑰存放區上使用這個方法應該不常使用。

語法

HRESULT SetKeyValue(
  PCWSTR       key,
  IModelObject *object
);

參數

key

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

object

要指派給索引鍵的值。 如果目前索引鍵的值是屬性存取子，則會在屬性存取子上呼叫 SetValue 方法，以設定基礎值。

傳回值

這個方法會傳回 HRESULT，指出成功或失敗。

備註

程式碼範例

ComPtr<IKeyStore> spMetadata; /* get a metadata store */
ComPtr<IModelObject> spValue; /* get a value to set */

// This never creates a key.  Most callers should prefer SetKey
if (SUCCEEDED(spMetadata->SetKeyValue(L"KnownExistingKey", spValue.Get()))
{
    // The key's value was successfully set.
}

規格需求

需求	值
標頭	dbgmodel.h

另請參閱

IKeyStore 介面