IWbemCallResult::GetResultObject-Methode (wbemcli.h)

  • Artikel

Die IWbemCallResult::GetResultObject-Methode versucht, ein Objekt aus einem vorherigen semisynchronen Aufruf von IWbemServices::GetObject oder IWbemServices::ExecMethod abzurufen. Wenn das Objekt noch nicht verfügbar ist, gibt der Aufruf WBEM_S_TIMEDOUT zurück. Außerdem können Sie vor dem Aufrufen dieser Methode zum Abrufen des resultierenden Objekts IWbemCallResult::GetCallStatus aufrufen, bis WBEM_S_NO_ERROR zurückgegeben wird, was angibt, dass der ursprüngliche semisynchrone Vorgang abgeschlossen ist.

Syntax

HRESULT GetResultObject(
  [in]  long             lTimeout,
  [out] IWbemClassObject **ppResultObject
);

Parameter

[in] lTimeout

Gibt die maximale Zeit in Millisekunden an, die dieser Aufruf vor der Rückgabe blockiert. Wenn Sie die Konstante WBEM_INFINITE (0xFFFFFFFF) verwenden, blockiert der Aufruf, bis das Objekt verfügbar ist. Wenn Sie 0 verwenden, gibt der Aufruf sofort entweder das Objekt oder einen status Code zurück.

[out] ppResultObject

Dieser Parameter darf nicht NULL sein. Es empfängt die Kopie des Objekts, wenn es verfügbar wird. Sie müssen IWbemClassObject::Release für das zurückgegebene Objekt aufrufen, wenn das Objekt nicht mehr benötigt wird. Ein neues Objekt wird bei Einem Fehler nicht zurückgegeben.

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.

Wenn beim ursprünglichen semisynchronen Vorgang ein Fehler aufgetreten ist (z. B. wenn das Objekt nicht gefunden wurde oder die Methode nicht aufgerufen werden konnte), gibt diese Methode den Fehlercode zurück, den die ursprüngliche Funktion in ihrer synchronen Version zurückgegeben hätte.

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.

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::ExecMethod

IWbemServices::GetObject