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