WSManRunShellCommandEx, fonction (wsman.h)

Fournit les mêmes fonctionnalités que la fonction WSManRunShellCommand , avec l’ajout d’une option d’ID de commande. Si le serveur prend en charge le protocole, il crée la commande instance à l’aide de l’ID spécifié par le client. Si une commande avec l’ID spécifié existe déjà, le serveur ne parvient pas à créer la commande instance. Cette nouvelle fonctionnalité est disponible uniquement lorsque l’application cliente transmet l’indicateur WSMAN_FLAG_REQUESTED_API_VERSION_1_1 dans le cadre de l’appel à la fonction WSManInitialize .

Syntaxe

void WSManRunShellCommandEx(
  [in, out]      WSMAN_SHELL_HANDLE    shell,
                 DWORD                 flags,
  [in]           PCWSTR                commandId,
  [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 égal à 0.

[in] commandId

Id de commande spécifié par le client.

[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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8
Serveur minimal pris en charge	Windows Server 2012
Plateforme cible	Windows
En-tête	wsman.h
Bibliothèque	WsmSvc.lib
DLL	WsmSvc.dll