IModelObject::SetKeyValue-Methode (dbgmodel.h)

  • Artikel

Die SetKeyValue-Methode ist die erste Methode, die ein Client verwendet, um den Wert eines Schlüssels festzulegen. Diese Methode kann nicht verwendet werden, um einen neuen Schlüssel für ein -Objekt zu erstellen. Es wird nur der Wert eines vorhandenen Schlüssels festgelegt. Beachten Sie, dass viele Schlüssel schreibgeschützt sind (z. B. werden sie von einem Eigenschaftsaccessor implementiert, der E_NOT_IMPL aus der SetValue-Methode zurückgibt). Diese Methode schlägt fehl, wenn sie für einen schreibgeschützten Schlüssel aufgerufen wird.

Syntax

HRESULT SetKeyValue(
  PCWSTR       key,
  IModelObject *object
);

Parameter

key

Der Name des Schlüssels, für den ein Wert festgelegt werden soll.

object

Der Wert des Schlüssels wird auf das objekt festgelegt, das in diesem Argument enthalten ist.

Rückgabewert

Diese Methode gibt HRESULT zurück, das den Erfolg oder Fehler angibt.

Hinweise

Codebeispiel

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

Anforderungen

Anforderung Wert
Header dbgmodel.h

Weitere Informationen

IModelObject-Schnittstelle