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

Статья
08/28/2023

Запускает выполнение команды в существующей оболочке и не ожидает завершения команды.

Синтаксис

void WSManRunShellCommand(
  [in, out]      WSMAN_SHELL_HANDLE    shell,
                 DWORD                 flags,
  [in]           PCWSTR                commandLine,
  [in, optional] WSMAN_COMMAND_ARG_SET *args,
  [in, optional] WSMAN_OPTION_SET      *options,
  [in]           WSMAN_SHELL_ASYNC     *async,
  [out]          WSMAN_COMMAND_HANDLE  *command
);

Параметры

[in, out] shell

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

flags

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

[in] commandLine

Определяет обязательную строку, завершающуюся null, которая представляет выполняемую команду. Как правило, команда указывается без аргументов, которые указываются отдельно. Однако с помощью этого параметра пользователь может указать командную строку и все аргументы. Если для параметра commandLine указаны аргументы, параметр args должен иметь значение NULL.

[in, optional] args

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

[in, optional] options

Определяет набор параметров для команды. Эти параметры передаются службе для изменения или уточнения выполнения команды. Этот параметр может принимать значение NULL. Дополнительные сведения о параметрах см. в разделе WSMAN_OPTION_SET.

[in] async

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

[out] command

Определяет объект команды, связанный с командой в оболочке. Этот дескриптор возвращается при успешном вызове и используется для отправки и получения данных, а также для передачи сигналов команде. Этот дескриптор следует закрыть, вызвав метод WSManCloseCommand . Этот параметр не может иметь значение 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 с пакетом обновления 2 (SP2)

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