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

La méthode SetKeyValue est analogue à la méthode SetKeyValue sur IModelObject. Cette méthode n’est pas capable de créer une nouvelle clé dans le magasin de métadonnées. S’il existe une clé existante comme indiqué par l’argument clé, sa valeur est définie comme indiqué. Si la clé est un accesseur de propriété, la méthode SetValue est appelée sur l’accesseur de propriété afin de définir la valeur sous-jacente. Notez que les métadonnées sont généralement statiques une fois créées. L’utilisation de cette méthode sur un magasin de clés de métadonnées doit être peu fréquente.

Syntaxe

HRESULT SetKeyValue(
  PCWSTR       key,
  IModelObject *object
);

Paramètres

key

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

object

Valeur à affecter à la clé. Si la valeur de la clé actuelle est un accesseur de propriété, la méthode SetValue est appelée sur l’accesseur de propriété pour définir la valeur sous-jacente.

Valeur retournée

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

Remarques

Exemple de code

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

Configuration requise

Condition requise	Valeur
En-tête	dbgmodel.h

Voir aussi

Interface IKeyStore