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

Article
03/03/2024

La méthode IWbemCallResult ::GetResultString retourne le chemin d’accès de l’objet affecté d’un instance nouvellement créé par IWbemServices ::P utInstance.

Note L’objet de résultat de l’appel est principalement utilisé lorsque l’appel PutInstance est effectué par un fournisseur et que le client doit connaître le chemin d’accès de l’objet (les valeurs des propriétés de clé) attribué au fournisseur. Par exemple, si la propriété de clé de classe est un identificateur global unique (GUID), attribué par le fournisseur pendant l’opération PutInstance , le client n’aurait aucun moyen de connaître ce GUID, sauf si le fournisseur a pu le retourner de cette manière.

Syntaxe

HRESULT GetResultString(
  [in]  long lTimeout,
  [out] BSTR *pstrResultString
);

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 le chemin d’accès de l’objet soit disponible. Si vous utilisez 0, l’appel retourne immédiatement le chemin d’accès de l’objet ou un code status.

[out] pstrResultString

Ne peut pas être NULL. Ce paramètre reçoit un pointeur vers le chemin d’accès de l’objet, qui, à son tour, mène à l’objet nouvellement créé. La chaîne retournée doit être libérée à l’aide de l’appel système SysFreeString. En cas d’erreur, aucune nouvelle chaîne n’est retourné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.

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

Condition requise	Valeur
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)

Voir aussi

IWbemCallResult

IWbemServices::PutInstance

Partager via