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

Article
08/27/2023

La méthode IWbemCallResult::GetCallStatus renvoie à l’utilisateur la status de l’appel semi-synchrone en cours. Lorsque cet appel retourne WBEM_S_NO_ERROR, l’appel d’origine à la méthode IWbemServices est terminé.

Syntaxe

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

Paramètres

[in] lTimeout

Spécifie la durée maximale en millisecondes que cet appel bloque avant qu’il ne retourne. Si vous utilisez la constante WBEM_INFINITE (0xFFFFFFFF), l’appel se bloque jusqu’à ce que l’appel semi-synchrone d’origine à une méthode IWbemServices soit terminé. Si vous utilisez 0 (zéro), l’appel retourne immédiatement l’appel status.

[out] plStatus

Si WBEM_S_NO_ERROR retourne dans le HRESULT à cette méthode, ce paramètre reçoit le résultat final status d’un appel à l’une des méthodes IWbemServices : OpenNamespace, PutInstance, PutClass, GetObject, DeleteInstance, DeleteClass ou ExecMethod. En cas d’erreur, la valeur pointée par plStatus n’est pas utilisée.

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.

Remarques

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.

Après avoir appelé une méthode IWbemServices semi-synchronisée, vous pouvez appeler GetCallStatus à tout moment pour déterminer si l’appel est terminé. Une fois que GetCallStatus a retourné WBEM_S_NO_ERROR, qui indique l’achèvement de l’opération IWbemServices d’origine, des appels à d’autres méthodes IWbemCallResult peuvent être nécessaires pour récupérer le résultat de l’appel, selon les règles suivantes :

Pour IWbemServices::OpenNamespace, la méthode GetResultServices doit être appelée pour récupérer le nouveau pointeur IWbemServices .
Pour IWbemServices::P utInstance, la méthode GetResultString doit être appelée pour obtenir le chemin d’accès de l’objet qui a été affecté à l’objet.
Pour IWbemServices::GetObject, la méthode GetResultObject doit être appelée pour récupérer l’objet.
Pour les méthodes IWbemServices DeleteInstance, DeleteClass et ExecMethod, la méthode GetCallStatus est le seul appel qui retourne des informations concernant ces opérations.

Configuration requise


Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	wbemcli.h (include Wbemidl.h)