IModelObject::SetKeyValue-Methode (dbgmodel.h)
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 |