Partager via


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