IKeyStore::SetKeyValue-Methode (dbgmodel.h)
Die SetKeyValue-Methode entspricht der SetKeyValue-Methode für IModelObject. Diese Methode ist nicht in der Lage, einen neuen Schlüssel im Metadatenspeicher zu erstellen. Wenn ein vorhandener Schlüssel vorhanden ist, wie durch das Schlüsselargument angegeben, wird der Wert wie angegeben festgelegt. Wenn der Schlüssel ein Eigenschaftsaccessor ist, wird die SetValue-Methode für den Eigenschaftenaccessor 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 Eigenschaftsaccessor ist, wird die SetValue-Methode für den Eigenschaftsaccessor aufgerufen, um den zugrunde liegenden Wert festzulegen.
Rückgabewert
Diese Methode gibt HRESULT zurück, das 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
| Anforderung | Wert |
|---|---|
| Header- | dbgmodel.h |