IKeyStore::SetKeyValue-Methode (dbgmodel.h)

Die SetKeyValue-Methode ist analog zur SetKeyValue-Methode auf IModelObject. Diese Methode ist nicht in der Lage, einen neuen Schlüssel im Metadatenspeicher zu erstellen. Wenn ein vorhandener Schlüssel durch das Schlüsselargument angegeben ist, wird der Wert wie angegeben festgelegt. Wenn der Schlüssel ein Eigenschaftszugriff ist, wird die SetValue-Methode auf dem Eigenschaftszugriffsor aufgerufen, um den zugrunde liegenden Wert festzulegen. Beachten Sie, dass Metadaten in der Regel statisch sind, sobald sie erstellt wurden. Die Verwendung dieser Methode für einen Metadatenschlüsselspeicher sollte selten sein.

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, der dem Schlüssel zugewiesen werden soll. Wenn der Wert des aktuellen Schlüssels ein Eigenschaftszugriff ist, wird die SetValue-Methode auf dem Eigenschaftszugriff aufgerufen, um den zugrunde liegenden Wert festzulegen.

Rückgabewert

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

Bemerkungen

Codebeispiel

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

Anforderungen

   
Header dbgmodel.h

Weitere Informationen

IKeyStore-Schnittstelle