Compartilhar via


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

O método SetKey é análogo ao método SetKey em IModelObject. É o único método que é capaz de criar uma chave e associar metadados a ela dentro do repositório de chaves.

Sintaxe

HRESULT SetKey(
  PCWSTR       key,
  IModelObject *object,
  IKeyStore    *metadata
);

Parâmetros

key

O nome da chave para a qual criar ou definir um valor.

object

O valor da chave.

metadata

Metadados opcionais a serem associados a essa chave. Não há uso presente para metadados de segundo nível. Portanto, esse argumento normalmente deve ser especificado como nulo.

Retornar valor

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

Comentários

Exemplo de código

ComPtr<IDataModelManager> spManager; /* get the data model manager */
ComPtr<IKeyStore> spMetadata;        /* get or create a metadata store */

ComPtr<IModelObject> sp16;
VARIANT vt16;
vt16.vt = VT_UI4;
vt16.ulVal = 16;
if (SUCCEEDED(spManager->CreateIntrinsicObject(ObjectIntrinsic, &vt16, &sp16)))
{
    if (SUCCEEDED(spMetadata->SetKey(L"PreferredRadix", sp16.Get(), nullptr)))
    {
        // The 'PreferredRadix' key has been set to 16 (even if it did 
        // not exist).  If this metadata store is passed to something like
        // IStringDisplayableConcept::ToDisplayString, the conversion of numbers 
        // will happen in hexadecimal instead of the default radix.
    }
}

Requisitos

Requisito Valor
Cabeçalho dbgmodel.h

Confira também

Interface IKeyStore