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 |