WSMAN_PLUGIN_SIGNAL función de devolución de llamada (wsman.h)

Artículo
08/28/2023

Define la devolución de llamada de señal para un complemento. Se llama a esta función cuando se recibe una señal de entrada desde una llamada de cliente.

El nombre del punto de entrada dll para este método debe ser WSManPluginSignal.

Sintaxis

WSMAN_PLUGIN_SIGNAL WsmanPluginSignal;

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

Parámetros

[in] requestDetails

Puntero a una estructura de WSMAN_PLUGIN_REQUEST que especifica el URI del recurso, las opciones, la configuración regional, la marca de apagado y el identificador de la solicitud.

[in] flags

Reservado para uso futuro. Debe ser cero.

[in] shellContext

Especifica el contexto que se recibió cuando se creó el shell.

[in, optional] commandContext

Si esta solicitud está destinada a un comando y no a un shell, este es el contexto devuelto por la operación de creación de winrm ; de lo contrario, este parámetro es NULL.

[in] code

Especifica la señal que se recibe del cliente. Los códigos siguientes son comunes.

WSMAN_SIGNAL_SHELL_CODE_TERMINATE

Se cerró el shell o la ventana del símbolo del sistema. El complemento debe llamar a la función WSManPluginOperationComplete .

WSMAN_SIGNAL_SHELL_CODE_CTRL_C

Se recibió la señal para CTRL+C y se detuvo el proceso. El complemento debe llamar a la función WSManPluginOperationComplete .

WSMAN_SIGNAL_SHELL_CODE_CTRL_BREAK

Se recibió la señal de CTRL+BREAK y se detuvo el proceso. El complemento debe llamar a la función WSManPluginOperationComplete .

Valor devuelto

None

Observaciones

Se puede recibir una señal para procesar una secuencia CTRL+C o uno de muchos otros tipos de señales personalizadas. Se llama a la devolución de llamada una vez para cada señal que se recibe. El complemento determina qué señales hacen que los comandos o shells se apaguen. Dado que las señales son específicas del shell, el complemento debe iniciar el apagado llamando al método WSManPluginOperationComplete . Para cada llamada, el complemento debe llamar a WSManPluginOperationComplete para confirmar la recepción y permitir que se reciba la siguiente señal.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7
Servidor mínimo compatible	Windows Server 2008 R2
Plataforma de destino	Windows
Encabezado	wsman.h
Redistribuible	Windows Management Framework en Windows Server 2008 con SP2 y Windows Vista con SP2

Compartir a través de