Compartilhar via


Método IKeyStore::SetKeyValue (dbgmodel.h)

O método SetKeyValue é análogo ao método SetKeyValue em IModelObject. Esse método não é capaz de criar uma nova chave dentro do repositório de metadados. Se houver uma chave existente conforme indicado pelo argumento key, seu valor será definido conforme indicado. Se a chave for um acessador de propriedade, o método SetValue será chamado no acessador de propriedade para definir o valor subjacente. Observe que os metadados normalmente são estáticos depois de criados. O uso desse método em um repositório de chaves de metadados deve ser pouco frequente.

Sintaxe

HRESULT SetKeyValue(
  PCWSTR       key,
  IModelObject *object
);

Parâmetros

key

O nome da chave para a qual definir um valor.

object

O valor a ser atribuído à chave. Se o valor da chave atual for um acessador de propriedade, o método SetValue será chamado no acessador de propriedade para definir o valor subjacente.

Retornar valor

Esse método retorna HRESULT que indica êxito ou falha.

Comentários

Exemplo de código

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.
}

Requisitos

Requisito Valor
Cabeçalho dbgmodel.h

Confira também

Interface IKeyStore