IModelObject::GetKeyValue-Methode (dbgmodel.h)

  • Artikel

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

Weitere Informationen

IModelObject-Schnittstelle