Fonction WSManPluginReceiveResult (wsman.h)
Signale les résultats de l’appel de plug-in WSMAN_PLUGIN_RECEIVE et est utilisé par la plupart des plug-ins d’interpréteur de commandes qui retournent des résultats. Une fois toutes les données reçues, la méthode WSManPluginOperationComplete doit être appelée.
Syntaxe
DWORD WSManPluginReceiveResult(
[in] WSMAN_PLUGIN_REQUEST *requestDetails,
[in] DWORD flags,
[in, optional] PCWSTR stream,
[in, optional] WSMAN_DATA *streamResult,
[in, optional] PCWSTR commandState,
[in] DWORD exitCode
);
Paramètres
[in] requestDetails
Pointeur vers une structure de WSMAN_PLUGIN_REQUEST qui spécifie l’URI de ressource, les options, les paramètres régionaux, l’indicateur d’arrêt et le handle pour la demande.
[in] flags
Réservé pour un usage futur. Doit être défini sur zéro.
[in, optional] stream
Spécifie le flux auquel les données sont associées. N’importe quel flux peut être utilisé, mais les flux standard sont STDIN, STDOUT et STDERR.
[in, optional] streamResult
Pointeur vers une structure WSMAN_DATA qui spécifie l’objet de résultat retourné au client. Le résultat peut être au format binaire ou XML.
[in, optional] commandState
Spécifie l’état de la commande. Ce paramètre doit être défini sur l’une des valeurs suivantes ou sur une valeur définie par le plug-in.
WSMAN_RECEIVE_STATE_NONE
L’opération ne nécessite aucune action.
WSMAN_RECEIVE_STATE_NORMAL_TERMINATION
L’opération s’est terminée normalement.
WSMAN_RECEIVE_STATE_ABNORMAL_TERMINATION
L’opération a été arrêtée de manière inattendue.
WSMAN_RECEIVE_STATE_WAITING
L’opération est en attente d’entrée.
WSMAN_RECEIVE_STATE_INPUT_REQUIRED
L’opération nécessite une entrée de ligne de commande.
[in] exitCode
Ignoré dans tous les cas, sauf lorsque commandState est WSMAN_RECEIVE_STATE_NORMAL_TERMINATION ou WSMAN_RECEIVE_STATE_ABNORMAL_TERMINATION. Chaque résultat peut avoir des codes d’erreur distincts. Si la commande ou le flux a échoué, le plug-in doit appeler la méthode WSManPluginOperationComplete .
Valeur de retour
None
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows 7 |
Serveur minimal pris en charge | Windows Server 2008 R2 |
Plateforme cible | Windows |
En-tête | wsman.h |
Bibliothèque | WsmSvc.lib |
DLL | WsmSvc.dll |
Composant redistribuable | Windows Management Framework sur Windows Server 2008 avec SP2 et Windows Vista avec SP2 |