Fonction WSManSignalShell (wsman.h)

Article
03/13/2024

Envoie un code de contrôle à une commande existante ou à l’interpréteur de commandes lui-même.

Syntaxe

void WSManSignalShell(
  [in]           WSMAN_SHELL_HANDLE     shell,
  [in, optional] WSMAN_COMMAND_HANDLE   command,
                 DWORD                  flags,
  [in]           PCWSTR                 code,
  [in]           WSMAN_SHELL_ASYNC      *async,
  [out]          WSMAN_OPERATION_HANDLE *signalOperation
);

Paramètres

[in] shell

Spécifie le handle retourné par un appel WSManCreateShell . Ce paramètre ne peut pas avoir la valeur NULL.

[in, optional] command

Spécifie le handle de commande retourné par un appel WSManRunShellCommand . Si cette valeur est NULL, le code de signal est envoyé à l’interpréteur de commandes.

flags

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

[in] code

Spécifie le code de signal à envoyer à la commande ou à l’interpréteur de commandes. Les codes suivants sont courants.

WSMAN_SIGNAL_SHELL_CODE_TERMINATE

La fenêtre d’interpréteur de commandes ou d’invite de commandes a été fermée.

WSMAN_SIGNAL_SHELL_CODE_CTRL_C

Le signal ctrl+C a été reçu et le processus a été arrêté.

WSMAN_SIGNAL_SHELL_CODE_CTRL_BREAK

Le signal ctrl+arrêt a été reçu et le processus a été arrêté.

[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 WSManCloseOperation .

[out] signalOperation

Définit le handle d’opération pour l’opération de signal. Ce handle est retourné à partir d’un appel réussi de la fonction et peut être utilisé pour annuler de manière asynchrone l’opération de signal. Ce handle doit être fermé en appelant la méthode WSManCloseOperation . Ce paramètre ne peut pas avoir la valeur NULL.

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, Windows Vista avec SP1 et Windows Vista avec SP2

Share via