Metodo IWbemCallResult::GetResultObject (wbemcli.h)

  • Articolo

Il metodo IWbemCallResult::GetResultObject tenta di recuperare un oggetto da una chiamata semisynchronous precedente a IWbemServices::GetObject o IWbemServices::ExecMethod. Se l'oggetto non è ancora disponibile, la chiamata restituisce WBEM_S_TIMEDOUT. Prima di richiamare questo metodo per ottenere l'oggetto risultante, è anche possibile chiamare IWbemCallResult::GetCallStatus finché non restituisce WBEM_S_NO_ERROR, indicando che l'operazione semisynchronous originale è completata.

Sintassi

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

Parametri

[in] lTimeout

Specifica il tempo massimo in millisecondi che questa chiamata blocca prima di restituire. Se si usa la costante WBEM_INFINITE (0xFFFFFFFF ), le chiamate non vengono bloccate finché l'oggetto non è disponibile. Se si usa 0, la chiamata restituisce immediatamente l'oggetto o un codice di stato.

[out] ppResultObject

Questo parametro non può essere NULL. Riceve la copia dell'oggetto quando diventa disponibile. È necessario chiamare IWbemClassObject::Release nell'oggetto restituito quando l'oggetto non è più necessario. Un nuovo oggetto non viene restituito in caso di errore.

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.

Se l'operazione semisynchrono originale non è riuscita (ad esempio quando l'oggetto non è stato trovato o non è stato possibile richiamare il metodo), questo metodo restituisce il codice di errore restituito dalla funzione originale nella versione sincrona.

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.

Requisiti

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

Vedi anche

IWbemCallResult

IWbemServices::ExecMethod

IWbemServices::GetObject