IWbemContext::GetValue-Methode (wbemcli.h)

Die IWbemContext::GetValue-Methode wird verwendet, um einen bestimmten benannten Kontextwert anhand des Namens abzurufen.

Syntax

HRESULT GetValue(
  [in]  LPCWSTR wszName,
  [in]  long    lFlags,
  [out] VARIANT *pValue
);

Parameter

[in] wszName

Name, für den der Wert abgerufen werden soll. Dies muss auf einen gültigen BSTR verweisen. Der Zeiger wird als schreibgeschützt behandelt.

[in] lFlags

Reserviert. Dieser Parameter muss 0 sein.

[out] pValue

Dieser Parameter darf nicht NULL sein und muss auf einen nicht initialisierten VARIANT-Wert verweisen. Wenn kein Fehler zurückgegeben wird, wird variant mit VariantInit initialisiert und dann auf den Kontextwert festgelegt. Der Aufrufer muss VariantClear für diesen Zeiger aufrufen, wenn der Wert nicht mehr benötigt wird. Wenn ein Fehlercode zurückgegeben wird, bleibt der VARIANT-Wert , auf den pValue verweist, unverändert.

Es ist möglich, dass ein gesamtes IWbemClassObject-Objekt innerhalb des VARIANT zurückgegeben werden kann. Wenn dies der Fall ist, ist VT_UNKNOWN der VARIANT-Typ . Der Aufrufer kann den IUnknown-Zeiger verwenden und QueryInterface ausführen, um den IWbemClassObject-Zeiger abzurufen.

Rückgabewert

Diese Methode gibt ein HRESULT zurück, das den Status des Methodenaufrufs angibt. In der folgenden Liste ist der in einem HRESULT enthaltene Wert aufgeführt.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista
Unterstützte Mindestversion (Server) Windows Server 2008
Zielplattform Windows
Kopfzeile wbemcli.h (include Wbemidl.h)
Bibliothek Wbemuuid.lib
DLL Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Wbemcomn.dll; Wbemcore.dll; Wbemess.dll; Wmipjobj.dll

Weitere Informationen

IWbemContext

IWbemContext::SetValue