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

  • Article

La méthode SetKey est analogue à la méthode SetKey sur IModelObject. Il s’agit de la seule méthode capable de créer une clé et de lui associer des métadonnées dans le magasin de clés.

Syntaxe

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

Paramètres

key

Nom de la clé pour laquelle créer ou définir une valeur.

object

Valeur de la clé.

metadata

Métadonnées facultatives à associer à cette clé. Il n’existe actuellement aucune utilisation pour les métadonnées de deuxième niveau. Cet argument doit donc généralement être spécifié comme null.

Valeur retournée

Cette méthode retourne HRESULT qui indique la réussite ou l’échec.

Remarques

Exemple de code

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

Configuration requise

Condition requise Valeur
En-tête dbgmodel.h

Voir aussi

Interface IKeyStore