Metodo IWbemCallResult::GetCallStatus (wbemcli.h)

Articolo
08/27/2023

Il metodo IWbemCallResult::GetCallStatus restituisce all'utente lo stato della chiamata semisynchrono corrente in sospeso. Quando questa chiamata restituisce WBEM_S_NO_ERROR, la chiamata originale al metodo IWbemServices è completata.

Sintassi

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

Parametri

[in] lTimeout

Specifica il tempo massimo in millisecondi che questa chiamata blocca prima che venga restituita. Se si usa la costante WBEM_INFINITE (0xFFFFFFFF ), le chiamate non vengono completate fino alla chiamata semisynchrono originale a un metodo IWbemServices . Se si usa 0 (zero), la chiamata restituisce immediatamente lo stato della chiamata.

[out] plStatus

Se WBEM_S_NO_ERROR restituisce in HRESULT a questo metodo, questo parametro riceverà lo stato finale del risultato di una chiamata a uno dei metodi IWbemServices : OpenNamespace, PutInstance, PutClass, GetObject, DeleteInstance, DeleteClass o ExecMethod. In caso di errore, il valore puntato da plStatus non verrà usato.

Valore restituito

Questo metodo restituisce un valore HRESULT che indica lo stato della chiamata al metodo. L'elenco seguente elenca il valore contenuto in un HRESULT.

Commenti

In caso di errore, è possibile chiamare la funzione COM GetErrorInfo per ottenere altre informazioni sull'errore. I codici di errore specifici di COM possono essere restituiti anche se i problemi di rete causano la perdita della connessione remota a Gestione Windows.

Dopo aver richiamato un metodo IWbemServices in modo semisynchronous, è possibile chiamare GetCallStatus in qualsiasi momento per determinare se la chiamata è stata completata. Dopo aver restituito WBEM_S_NO_ERRORGetCallStatus, che indica il completamento dell'operazione IWbemServices originale, le chiamate ad altri metodi IWbemCallResult potrebbero essere necessari per recuperare il risultato della chiamata, in base alle regole seguenti:

Per IWbemServices::OpenNamespace, il metodo GetResultServices deve essere chiamato per recuperare il nuovo puntatore IWbemServices .
Per IWbemServices::P utInstance, il metodo GetResultString deve essere chiamato per ottenere il percorso dell'oggetto assegnato all'oggetto.
Per IWbemServices::GetObject, il metodo GetResultObject deve essere chiamato per recuperare l'oggetto.
Per i metodi IWbemServices DeleteInstance, DeleteClass e ExecMethod, il metodo GetCallStatus è l'unica chiamata che restituisce informazioni relative a queste operazioni.

Requisiti


Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	wbemcli.h (include Wbemidl.h)