IModelObject ::SetKeyValue, méthode (dbgmodel.h)
La méthode SetKeyValue est la première méthode vers laquelle un client se tourne pour définir la valeur d’une clé. Cette méthode ne peut pas être utilisée pour créer une clé sur un objet . Elle définit uniquement la valeur d’une clé existante. Notez que de nombreuses clés sont en lecture seule (par exemple, elles sont implémentées par un accesseur de propriété qui retourne E_NOT_IMPL à partir de sa méthode SetValue). Cette méthode échoue lorsqu’elle est appelée sur une clé en lecture seule.
Syntaxe
HRESULT SetKeyValue(
PCWSTR key,
IModelObject *object
);
Paramètres
key
Nom de la clé pour laquelle définir une valeur.
object
La valeur de la clé est définie sur l’objet contenu dans cet argument.
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<IModelObject> spObject; /* get an object with a key named SomeKey */
// Box (int)42:
VARIANT vtVal;
vtVal.vt = VT_I4;
vtVal.lVal = 42;
ComPtr<IModelObject> spNewObject;
if (SUCCEEDED(spManager->CreateIntrinsicObject(ObjectIntrinsic, &vtVal, &spNewObject)))
{
// Set the value of "SomeKey" to our newly boxed 42:
if (SUCCEEDED(spObject->SetKeyValue(L"SomeKey", spNewObject.Get()))
{
// The key value has been set!
}
}
Configuration requise
Condition requise | Valeur |
---|---|
En-tête | dbgmodel.h |