IModelObject::GetKeyValue-Methode (dbgmodel.h)

Die GetKeyValue-Methode ist die erste Methode, an die ein Client sich wendet, um den Wert (und die metadaten, die einem bestimmten Schlüssel zugeordnet sind) anhand des Namens abzurufen. Wenn es sich bei dem Schlüssel um einen Eigenschaftsaccessor handelt – d. h. als IModelObject- ein boxed IModelPropertyAccessor, ruft die GetKeyValue-Methode automatisch die GetValue-Methode des Eigenschaftenzugriffs 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 werden erweiterte Fehlerinformationen in diesem Argument möglicherweise übergeben, obwohl die Methode ein fehlerhaftes HRESULT zurückgibt.

metadata

Der diesem Schlüssel zugeordnete Metadatenspeicher wird optional in diesem Argument zurückgegeben.

Rückgabewert

Diese Methode gibt HRESULT zurück, das Erfolg oder Fehler angibt. Die Rückgabewerte E_BOUNDS (oder E_NOT_SET in einigen Fällen) deuten darauf hin, dass der Schlüssel nicht gefunden wurde.

Bemerkungen

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

Siehe auch

IModelObject-Schnittstelle