функция обратного вызова WSMAN_PLUGIN_SIGNAL (wsman.h)

Статья
03/13/2024

Определяет обратный вызов сигнала для подключаемого модуля. Эта функция вызывается при получении входящего сигнала от вызова клиента.

Имя точки входа DLL для этого метода должно быть WSManPluginSignal.

Синтаксис

WSMAN_PLUGIN_SIGNAL WsmanPluginSignal;

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

Параметры

[in] requestDetails

Указатель на структуру WSMAN_PLUGIN_REQUEST , указывающую URI ресурса, параметры, языковой стандарт, флаг завершения работы и дескриптор запроса.

[in] flags

Зарезервировано для последующего использования. Должен равняться нулю.

[in] shellContext

Указывает контекст, полученный при создании оболочки.

[in, optional] commandContext

Если этот запрос предназначен для команды, а не оболочки, это контекст, возвращаемый операцией создания winrm ; В противном случае этот параметр имеет значение NULL.

[in] code

Указывает сигнал, полученный от клиента. Ниже приведены распространенные коды.

WSMAN_SIGNAL_SHELL_CODE_TERMINATE

Оболочка или окно командной строки были закрыты. Подключаемый модуль должен вызывать функцию WSManPluginOperationComplete .

WSMAN_SIGNAL_SHELL_CODE_CTRL_C

Был получен сигнал ctrl+C, и процесс был остановлен. Подключаемый модуль должен вызывать функцию WSManPluginOperationComplete .

WSMAN_SIGNAL_SHELL_CODE_CTRL_BREAK

Был получен сигнал ctrl+BREAK, и процесс был остановлен. Подключаемый модуль должен вызывать функцию WSManPluginOperationComplete .

Возвращаемое значение

None

Remarks

Можно получить сигнал для обработки последовательности CTRL+C или одного из многих других типов пользовательских сигналов. Обратный вызов вызывается один раз для каждого полученного сигнала. Подключаемый модуль определяет, какие сигналы вызывают завершение работы команд и (или) оболочек. Так как сигналы зависят от оболочки, подключаемый модуль должен инициировать завершение работы путем вызова метода WSManPluginOperationComplete . Для каждого вызова подключаемый модуль должен вызывать WSManPluginOperationComplete , чтобы подтвердить получение и разрешить получение следующего сигнала.

Требования

Требование	Значение
Минимальная версия клиента	Windows 7
Минимальная версия сервера	Windows Server 2008 R2
Целевая платформа	Windows
Header	wsman.h
Распространяемые компоненты	Windows Management Framework в Windows Server 2008 с пакетом обновления 2 (SP2) и Windows Vista с пакетом обновления 2 (SP2)

Поделиться через