WSManRunShellCommand, fonction (wsman.h)

Article
08/28/2023

Démarre l’exécution d’une commande dans un interpréteur de commandes existant et n’attend pas la fin de la commande.

Syntaxe

void WSManRunShellCommand(
  [in, out]      WSMAN_SHELL_HANDLE    shell,
                 DWORD                 flags,
  [in]           PCWSTR                commandLine,
  [in, optional] WSMAN_COMMAND_ARG_SET *args,
  [in, optional] WSMAN_OPTION_SET      *options,
  [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 être NULL.

flags

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

[in] commandLine

Définit une chaîne terminée par un caractère Null obligatoire qui représente la commande à exécuter. En règle générale, la commande est spécifiée sans arguments, qui sont spécifiés séparément. Toutefois, un utilisateur peut spécifier la ligne de commande et tous les arguments à l’aide de ce paramètre. Si des arguments sont spécifiés pour le paramètre commandLine , le paramètre args doit être NULL.

[in, optional] args

Pointeur vers une structure WSMAN_COMMAND_ARG_SET qui définit un tableau de valeurs d’argument, qui sont passées à la commande lors de la création. Si aucun argument n’est requis, ce paramètre doit être NULL.

[in, optional] options

Définit un ensemble d’options pour la commande . Ces options sont passées 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] async

Définit une structure asynchrone. La structure asynchrone contient un contexte utilisateur facultatif et une fonction de rappel obligatoire. Pour plus d’informations, consultez la structure WSMAN_SHELL_ASYNC. Ce paramètre ne peut pas être NULL et doit être fermé en appelant la méthode WSManCloseCommand .

[out] command

Définit l’objet de commande associé à une commande dans un interpréteur de commandes. 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. Ce handle doit être fermé en appelant la méthode WSManCloseCommand . Ce paramètre ne peut pas être NULL.

Valeur de retour

None

Spécifications


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

Share via