IModelObject ::SetKeyValue, méthode (dbgmodel.h)

  • Article

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

Voir aussi

Interface IModelObject