IKeyStore::GetKeyValue-Methode (dbgmodel.h)
Die GetKeyValue-Methode ist die erste Methode, zu der ein Client wechselt, um den Wert eines bestimmten Schlüssels im Metadatenspeicher zu ermitteln. Wenn der durch das Schlüsselargument angegebene Schlüssel innerhalb des Speichers (oder des übergeordneten Speichers) vorhanden ist, werden der Wert dieses Schlüssels und alle damit verbundenen Metadaten zurückgegeben. Wenn der Wert des Schlüssels ein Eigenschaftsaccessor ist (ein IModelPropertyAccessor , der in ein IModelObject geschachtelt ist), wird die GetValue-Methode des Eigenschaftsaccessors automatisch von GetKeyValue und der zugrunde liegende Wert der zurückgegebenen Eigenschaft aufgerufen.
Syntax
HRESULT GetKeyValue(
PCWSTR key,
_COM_Errorptr_opt_ IModelObject **object,
IKeyStore **metadata
);
Parameter
key
Der Name des Schlüssels, für den ein Wert zurückgegeben werden soll.
object
Der Wert des Schlüssels wird hier zurückgegeben. Wenn der Wert des Schlüssels ein Eigenschaftsaccessor ist, wird die GetValue-Methode für den Eigenschaftenaccessor aufgerufen, und dieser zugrunde liegende Wert wird hier zurückgegeben.
metadata
Alle Metadaten, die dem Schlüssel zugeordnet sind, werden hier optional zurückgegeben. Es gibt keine verwendung für Metadaten der zweiten Ebene. Dieses Argument sollte daher in der Regel als NULL angegeben werden.
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> spRadix;
if (SUCCEEDED(spMetadata->GetKeyValue(L"PreferredRadix", &spRadix, nullptr)))
{
// spRadix has the preferred display radix. Use GetIntrinsicValueAs to unbox.
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | dbgmodel.h |