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

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

  • Статья

Подключается к существующей команде, выполняемой в оболочке.

Синтаксис

void WSManConnectShellCommand(
  [in, out]      WSMAN_SHELL_HANDLE   shell,
                 DWORD                flags,
  [in]           PCWSTR               commandID,
  [in, optional] WSMAN_OPTION_SET     *options,
  [in, optional] WSMAN_DATA           *connectXml,
  [in]           WSMAN_SHELL_ASYNC    *async,
  [out]          WSMAN_COMMAND_HANDLE *command
);

Параметры

[in, out] shell

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

flags

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

[in] commandID

Строка, завершающаяся значением NULL, идентифицирующая определенную команду, которая в настоящее время выполняется в сеансе сервера, к которой клиент намерен подключиться.

[in, optional] options

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

[in, optional] connectXml

Указатель на структуру WSMAN_DATA , которая определяет открытый контекст для операции оболочки подключения. Содержимое должно быть допустимой XML-строкой. Этот параметр может принимать значение NULL.

[in] async

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

[out] command

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

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

None

Требования

Требование Значение
Минимальная версия клиента Windows 8
Минимальная версия сервера Windows Server 2012
Целевая платформа Windows
Header wsman.h
Библиотека WsmSvc.lib
DLL WsmSvc.dll