(dbgmodel.h) IKeyStore::SetKeyValue 方法

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 介面