IWbemServices::GetObject-Methode (wbemcli.h)

Artikel
08/27/2023

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