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 |