IWbemCallResult::GetCallStatus-Methode (wbemcli.h)

Artikel
08/27/2023

Die IWbemCallResult::GetCallStatus-Methode gibt dem Benutzer die status des aktuellen ausstehenden semisynchronen Aufrufs zurück. Wenn dieser Aufruf WBEM_S_NO_ERROR zurückgibt, ist der ursprüngliche Aufruf der IWbemServices-Methode abgeschlossen.

Syntax

HRESULT GetCallStatus(
  [in]  long lTimeout,
  [out] long *plStatus
);

Parameter

[in] lTimeout

Gibt die maximale Zeit in Millisekunden an, die dieser Aufruf blockiert, bevor er zurückgegeben wird. Wenn Sie die Konstante WBEM_INFINITE (0xFFFFFFFF) verwenden, wird der Aufruf blockiert, bis der ursprüngliche semisynchrone Aufruf einer IWbemServices-Methode abgeschlossen ist. Wenn Sie 0 (null) verwenden, gibt der Aufruf sofort den Aufruf status zurück.

[out] plStatus

Wenn WBEM_S_NO_ERROR im HRESULT zu dieser Methode zurückgibt, erhält dieser Parameter das Endergebnis status eines Aufrufs einer der IWbemServices-Methoden: OpenNamespace, PutInstance, PutClass, GetObject, DeleteInstance, DeleteClass oder ExecMethod. Bei Fehler wird der Wert, auf den von plStatus verwiesen wird, nicht verwendet.

Rückgabewert

Diese Methode gibt ein HRESULT zurück, das den Status des Methodenaufrufs angibt. Die folgende Liste listet den Wert auf, der in einem HRESULT enthalten ist.

Hinweise

Bei Fehler können Sie die COM-Funktion GetErrorInfo aufrufen, um weitere Fehlerinformationen abzurufen. COM-spezifische Fehlercodes können auch zurückgegeben werden, wenn Netzwerkprobleme dazu führen, dass die Remoteverbindung mit der Windows-Verwaltung verloren geht.

Nachdem Sie eine IWbemServices-Methode halbsynchron aufgerufen haben, können Sie GetCallStatus jederzeit aufrufen, um zu bestimmen, ob der Aufruf abgeschlossen ist. Nachdem GetCallStatusWBEM_S_NO_ERROR zurückgegeben hat, was den Abschluss des ursprünglichen IWbemServices-Vorgangs angibt, können Aufrufe anderer IWbemCallResult-Methoden erforderlich sein, um das Ergebnis des Aufrufs abzurufen, gemäß den folgenden Regeln:

Für IWbemServices::OpenNamespace muss die GetResultServices-Methode aufgerufen werden, um den neuen IWbemServices-Zeiger abzurufen.
Für IWbemServices::P utInstance muss die GetResultString-Methode aufgerufen werden, um den Objektpfad abzurufen, der dem Objekt zugewiesen wurde.
Für IWbemServices::GetObject muss die GetResultObject-Methode aufgerufen werden, um das Objekt abzurufen.
Für die IWbemServices-Methoden DeleteInstance, DeleteClass und ExecMethod ist die GetCallStatus-Methode der einzige Aufruf, der Informationen zu diesen Vorgängen zurückgibt.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	wbemcli.h (include Wbemidl.h)