IModelObject::GetKeyValue-Methode (dbgmodel.h)
Die GetKeyValue-Methode ist die erste Methode, an die sich ein Client wendet, um den Wert eines bestimmten Schlüssels (und die metadaten, die einem bestimmten Schlüssel nach Name zugeordnet sind) abzurufen. Wenn es sich bei dem Schlüssel um einen Eigenschaftszugriff handelt – d. h. als Wert als IModelObject , bei dem es sich um einen boxed IModelPropertyAccessor handelt, ruft die GetKeyValue-Methode automatisch die GetValue-Methode des Eigenschaftszugriffs auf, um den tatsächlichen Wert abzurufen.
Syntax
HRESULT GetKeyValue(
PCWSTR key,
_COM_Errorptr_opt_ IModelObject **object,
IKeyStore **metadata
);
Parameter
key
Der Name des Schlüssels, für den ein Wert abgerufen werden soll.
object
Der Wert des Schlüssels wird in diesem Argument zurückgegeben. In einigen Fehlerfällen können erweiterte Fehlerinformationen in diesem Argument übergeben werden, obwohl die Methode ein fehlerhaftes HRESULT zurückgibt.
metadata
Der diesem Schlüssel zugeordnete Metadatenspeicher wird in diesem Argument optional zurückgegeben.
Rückgabewert
Diese Methode gibt HRESULT zurück, das auf Erfolg oder Fehler hinweist. Die Rückgabewerte E_BOUNDS (oder in einigen Fällen E_NOT_SET) weisen darauf hin, dass der Schlüssel nicht gefunden werden konnte.
Hinweise
Codebeispiel
ComPtr<IModelObject> spProcess; /* get a process object */
ComPtr<IModelObject> spProcId;
if (SUCCEEDED(spProcess->GetKeyValue(L"Id", &spProcId, nullptr)))
{
// spProcId has a boxed process id. Use GetIntrinsicValueAs to unbox it.
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | dbgmodel.h |