IWbemServices::GetObject-Methode (wbemcli.h)
Die IWbemServices::GetObject-Methode ruft eine Klasse oder instance ab. Diese Methode ruft nur Objekte aus dem Namespace ab, der dem aktuellen IWbemServices-Objekt zugeordnet ist.
Syntax
HRESULT GetObject(
[in] const BSTR strObjectPath,
[in] long lFlags,
[in] IWbemContext *pCtx,
[out] IWbemClassObject **ppObject,
[out] IWbemCallResult **ppCallResult
);
Parameter
[in] strObjectPath
Pfad des abzurufenden Objekts. Wenn dies NULL ist, wird ein leeres Objekt zurückgegeben, das zu einer neuen Klasse werden kann. Weitere Informationen finden Sie unter Erstellen einer Klasse.
[in] lFlags
Die folgenden Flags wirken sich auf das Verhalten dieser Methode aus.
WBEM_FLAG_USE_AMENDED_QUALIFIERS
Wenn dieses Flag festgelegt ist, ruft WMI die geänderten Qualifizierer ab, die im lokalisierten Namespace des Gebietsschemas der aktuellen Verbindung gespeichert sind. Wenn nicht festgelegt, werden nur die im unmittelbaren Namespace gespeicherten Qualifizierer abgerufen.
WBEM_FLAG_RETURN_WBEM_COMPLETE
Dieses Flag macht dies zu einem synchronen Aufruf.
WBEM_FLAG_RETURN_IMMEDIATELY
Dieses Flag macht dies zu einem semisynchronen Aufruf. Sie müssen einen gültigen Zeiger für den ppCallResult-Parameter angeben. Weitere Informationen finden Sie unter Aufrufen einer Methode.
WBEM_FLAG_DIRECT_READ
Dieses Flag bewirkt einen direkten Zugriff auf den Anbieter für die angegebene Klasse ohne Rücksicht auf die übergeordnete Klasse oder Unterklassen.
[in] pCtx
In der Regel NULL. Andernfalls ist dies ein Zeiger auf ein IWbemContext-Objekt, das von dem Anbieter verwendet werden kann, der die angeforderte Klasse oder instance. Die Werte im Kontextobjekt müssen in der Dokumentation für den betreffenden Anbieter angegeben werden. Weitere Informationen zu diesem Parameter finden Sie unter Ausführen von Aufrufen an WMI.
[out] ppObject
Wenn nicht NULL, empfängt dieser das -Objekt, wenn es gefunden wird. Das zurückgegebene Objekt weist eine positive Verweisanzahl auf. Der Aufrufer muss Release verwenden, wenn das Objekt nicht mehr benötigt wird. In allen Fehlerfällen wird dieser Parameter so festgelegt, dass er auf NULL zeigt.
[out] ppCallResult
Wenn NULL, wird dieser Parameter nicht verwendet. Wenn der lFlags-ParameterWBEM_FLAG_RETURN_IMMEDIATELY enthält, wird dieser Aufruf sofort mit WBEM_S_NO_ERROR zurückgegeben. Der ppCallResult-Parameter empfängt einen Zeiger auf ein neues IWbemCallResult-Objekt , das dann abgefragt werden kann, um das Ergebnis mithilfe der GetCallStatus-Methode abzurufen. Der Aufrufer kann IWbemCallResult::GetResultObject aufrufen, um das Objekt abzurufen, sobald es verfügbar ist.
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.
Bei einem Fehler können Sie alle verfügbaren Informationen über die COM-Funktion GetErrorInfo abrufen.
COM-spezifische Fehlercodes können auch zurückgegeben werden, wenn Netzwerkprobleme dazu führen, dass die Remoteverbindung mit der Windows-Verwaltung verloren geht.
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 | Fastprox.dll; Esscli.dll; FrameDyn.dll; FrameDynOS.dll; Ntevt.dll; Stdprov.dll; Viewprov.dll; Wbemcomn.dll; Wbemcore.dll; Wbemess.dll; Wbemsvc.dll; Wmipicmp.dll; Wmidcprv.dll; Wmipjobj.dll; Wmiprvsd.dll |