IKeyStore::SetKeyValue 方法 (dbgmodel.h)

SetKeyValue 方法类似于 IModelObject 上的 SetKeyValue 方法。 此方法无法在元数据存储中创建新密钥。 如果存在由 key 参数指示的现有键,则其值将按指示进行设置。 如果键是属性访问器,则将在属性访问器上调用 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.
}

要求

要求
Header dbgmodel.h

另请参阅

IKeyStore 接口