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 no repositório de metadados. Se houver uma chave existente, conforme indicado pelo argumento chave, seu valor será definido como 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 uma vez 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.

Valor de retorno

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

Observações

de 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

Consulte também

interface IKeyStore