Freigeben über


IWbemCallResult::GetCallStatus-Methode (wbemcli.h)

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:

Anforderungen

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

Weitere Informationen

IWbemCallResult

IWbemServices::D eleteClass

IWbemServices::DeleteInstance

IWbemServices::ExecMethod

IWbemServices::GetObject

IWbemServices::OpenNamespace

IWbemServices::PutInstance