WSMAN_PLUGIN_SIGNAL fonction de rappel (wsman.h)

Définit le rappel de signal pour un plug-in. Cette fonction est appelée lorsqu’un signal entrant est reçu d’un appel client.

Le nom du point d’entrée dll pour cette méthode doit être WSManPluginSignal.

Syntaxe

WSMAN_PLUGIN_SIGNAL WsmanPluginSignal;

void WsmanPluginSignal(
  [in]           WSMAN_PLUGIN_REQUEST *requestDetails,
  [in]           DWORD flags,
  [in]           PVOID shellContext,
  [in, optional] PVOID commandContext,
  [in]           PCWSTR code
)
{...}

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 requête.

[in] flags

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

[in] shellContext

Spécifie le contexte reçu lors de la création de l’interpréteur de commandes.

[in, optional] commandContext

Si cette requête est destinée à une commande et non à un interpréteur de commandes, il s’agit du contexte retourné par l’opération winrm create ; sinon, ce paramètre est NULL.

[in] code

Spécifie le signal reçu du client. Les codes suivants sont courants.

WSMAN_SIGNAL_SHELL_CODE_TERMINATE

L’interpréteur de commandes ou la fenêtre d’invite de commandes a été fermée. Le plug-in doit appeler la fonction WSManPluginOperationComplete .

WSMAN_SIGNAL_SHELL_CODE_CTRL_C

Le signal pour CTRL+C a été reçu et le processus a été arrêté. Le plug-in doit appeler la fonction WSManPluginOperationComplete .

WSMAN_SIGNAL_SHELL_CODE_CTRL_BREAK

Le signal pour CTRL+ARRÊT a été reçu et le processus a été arrêté. Le plug-in doit appeler la fonction WSManPluginOperationComplete .

Valeur de retour

None

Remarques

Un signal peut être reçu pour traiter une séquence CTRL+C ou l’un des nombreux autres types de signaux personnalisés. Le rappel est appelé une fois pour chaque signal reçu. Le plug-in détermine les signaux qui provoquent l’arrêt des commandes et/ou des interpréteurs de commandes. Étant donné que les signaux sont spécifiques à l’interpréteur de commandes, le plug-in doit lancer l’arrêt en appelant la méthode WSManPluginOperationComplete . Pour chaque appel, le plug-in doit appeler WSManPluginOperationComplete pour accuser réception et permettre la réception du signal suivant.

Configuration requise