IKeyStore::SetKeyValue-Methode (dbgmodel.h)

  • Artikel

Die SetKeyValue-Methode entspricht der SetKeyValue-Methode auf IModelObject. Diese Methode ist nicht in der Lage, einen neuen Schlüssel im Metadatenspeicher zu erstellen. Wenn ein schlüssel vorhandener Schlüssel vorhanden ist, wie durch das Schlüsselargument angegeben, wird dessen Wert wie angegeben festgelegt. Wenn der Schlüssel ein Eigenschaftenaccessor ist, wird die SetValue-Methode für den Eigenschaftenaccessor aufgerufen, um den zugrunde liegenden Wert festzulegen. Beachten Sie, dass Metadaten nach der Erstellung in der Regel statisch sind. Die Verwendung dieser Methode für einen Metadatenschlüsselspeicher sollte selten erfolgen.

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 Eigenschaftsaccessor ist, wird die SetValue-Methode für den Eigenschaftenaccessor aufgerufen, um den zugrunde liegenden Wert festzulegen.

Rückgabewert

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

Hinweise

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

Anforderung Wert
Header dbgmodel.h

Weitere Informationen

IKeyStore-Schnittstelle