Функция WSManSignalShell (wsman.h)

Статья
03/13/2024

Отправляет код элемента управления в существующую команду или в саму оболочку.

Синтаксис

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
);

Параметры

[in] shell

Указывает дескриптор, возвращаемый вызовом WSManCreateShell . Этот параметр не может иметь значение NULL.

[in, optional] command

Указывает дескриптор команды, возвращаемый вызовом WSManRunShellCommand . Если это значение равно NULL, код сигнала отправляется в оболочку.

flags

Зарезервировано для последующего использования. Необходимо задать нулевое значение.

[in] code

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

WSMAN_SIGNAL_SHELL_CODE_TERMINATE

Оболочка или окно командной строки были закрыты.

WSMAN_SIGNAL_SHELL_CODE_CTRL_C

Был получен сигнал ctrl+C, и процесс был остановлен.

WSMAN_SIGNAL_SHELL_CODE_CTRL_BREAK

Был получен сигнал ctrl+BREAK, и процесс был остановлен.

[in] async

Определяет асинхронную структуру. Асинхронная структура содержит необязательный контекст пользователя и обязательную функцию обратного вызова. Дополнительные сведения см. в разделе структура WSMAN_SHELL_ASYNC . Этот параметр не может иметь значение NULL и должен быть закрыт путем вызова метода WSManCloseOperation .

[out] signalOperation

Определяет дескриптор операции сигнала. Этот дескриптор возвращается при успешном вызове функции и может использоваться для асинхронной отмены операции сигнала. Этот дескриптор следует закрыть, вызвав метод WSManCloseOperation . Этот параметр не может иметь значение NULL.

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

None

Требования

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

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