Compartilhar via


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

O método SetKey é análogo ao método SetKey em IModelObject. É o único método 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á nenhum uso presente para metadados de segundo nível. Esse argumento deve, portanto, normalmente ser especificado como nulo.

Valor de retorno

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

Observações

de 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

Consulte também

interface IKeyStore