Méthode IWbemCallResult::GetResultObject (wbemcli.h)

La méthode IWbemCallResult::GetResultObject tente de récupérer un objet à partir d’un appel semi-synchrone précédent à IWbemServices::GetObject ou IWbemServices::ExecMethod. Si l’objet n’est pas encore disponible, l’appel retourne WBEM_S_TIMEDOUT. En outre, avant d’appeler cette méthode pour obtenir l’objet résultant, vous pouvez appeler IWbemCallResult::GetCallStatus jusqu’à ce qu’elle retourne WBEM_S_NO_ERROR, indiquant que l’opération semi-synchrone d’origine est terminée.

Syntaxe

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

Paramètres

[in] lTimeout

Spécifie la durée maximale en millisecondes que cet appel bloque avant de retourner. Si vous utilisez la constante WBEM_INFINITE (0xFFFFFFFF), l’appel se bloque jusqu’à ce que l’objet soit disponible. Si vous utilisez 0, l’appel retourne immédiatement l’objet ou un code status.

[out] ppResultObject

Ce paramètre ne peut pas être NULL. Il reçoit la copie de l’objet lorsqu’il devient disponible. Vous devez appeler IWbemClassObject::Release sur l’objet retourné lorsque l’objet n’est plus nécessaire. Un nouvel objet n’est pas retourné en cas d’erreur.

Valeur retournée

Cette méthode retourne une valeur HRESULT qui indique le statut de l'appel de méthode. La liste suivante répertorie la valeur contenue dans un HRESULT.

Si l’opération semi-synchrone d’origine a échoué (par exemple, lorsque l’objet est introuvable ou que la méthode n’a pas pu être appelée), cette méthode retourne le code d’erreur que la fonction d’origine aurait retourné dans sa version synchrone.

En cas d’erreur, vous pouvez appeler la fonction COM GetErrorInfo pour obtenir plus d’informations sur l’erreur.

Des codes d’erreur spécifiques à COM peuvent également être retournés si des problèmes réseau vous font perdre la connexion à distance à Windows Management.

Configuration requise

Voir aussi

IWbemCallResult

IWbemServices::ExecMethod

IWbemServices::GetObject