Fonction WSManConnectShellCommand (wsman.h)

Se connecte à une commande existante en cours d’exécution dans un interpréteur de commandes.

Syntaxe

void WSManConnectShellCommand(
  [in, out]      WSMAN_SHELL_HANDLE   shell,
                 DWORD                flags,
  [in]           PCWSTR               commandID,
  [in, optional] WSMAN_OPTION_SET     *options,
  [in, optional] WSMAN_DATA           *connectXml,
  [in]           WSMAN_SHELL_ASYNC    *async,
  [out]          WSMAN_COMMAND_HANDLE *command
);

Paramètres

[in, out] shell

Spécifie le handle de l’interpréteur de commandes retourné par l’appel WSManCreateShell . Ce paramètre ne peut pas avoir la valeur NULL.

flags

Réservé pour un usage futur. Doit être zéro.

[in] commandID

Chaîne terminée par null qui identifie une commande spécifique, en cours d’exécution dans la session serveur, à laquelle le client a l’intention de se connecter.

[in, optional] options

Définit un ensemble d’options pour la commande. Ces options sont transmises au service pour modifier ou affiner l’exécution de la commande. Ce paramètre peut être NULL. Pour plus d’informations sur les options, consultez WSMAN_OPTION_SET.

[in, optional] connectXml

Pointeur vers une structure de WSMAN_DATA qui définit un contexte ouvert pour l’opération de connexion de l’interpréteur de commandes. Le contenu doit être une chaîne XML valide. Ce paramètre peut être NULL.

[in] async

Définit une structure asynchrone pour contenir un contexte utilisateur facultatif et une fonction de rappel obligatoire. Pour plus d’informations, consultez WSMAN_SHELL_ASYNC. Ce paramètre ne peut pas avoir la valeur NULL.

[out] command

Ce handle est retourné lors d’un appel réussi et est utilisé pour envoyer et recevoir des données et pour signaler la commande. Une fois que vous avez terminé d’utiliser ce handle, fermez-le en appelant la méthode WSManCloseCommand . Ce paramètre ne peut pas avoir la valeur NULL.

Valeur de retour

None

Configuration requise