IKeyStore ::SetKey, méthode (dbgmodel.h)
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 d’associer des métadonnées à celle-ci 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 aucune utilisation actuelle pour les métadonnées de deuxième niveau. Cet argument doit donc être spécifié comme null.
Valeur de retour
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.
}
}
Exigences
Exigence | Valeur |
---|---|
d’en-tête | dbgmodel.h |