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

структура WSMAN_SHELL_STARTUP_INFO_V10 (wsman.h)

  • Статья

Определяет параметры запуска оболочки, которые будут использоваться с функцией WSManCreateShell . Структура должна быть выделена клиентом и передана в функцию WSManCreateShell .

Конфигурация, переданная в функцию WSManCreateShell , может напрямую повлиять на поведение команды, выполняемой в оболочке. Типичным примером является аргумент workingDirectory , описывающий рабочий каталог, связанный с каждым процессом, который операционная система использует при попытке найти файлы, указанные с помощью относительного пути.

При отсутствии конкретных требований к именованию потоков клиенты и службы должны попытаться использовать STDIN для входных потоков, STDOUT для потока вывода по умолчанию и STDERR для потока вывода ошибок или состояния.

Синтаксис

typedef struct _WSMAN_SHELL_STARTUP_INFO_V10 {
  WSMAN_STREAM_ID_SET            *inputStreamSet;
  WSMAN_STREAM_ID_SET            *outputStreamSet;
  DWORD                          idleTimeoutMs;
  PCWSTR                         workingDirectory;
  WSMAN_ENVIRONMENT_VARIABLE_SET *variableSet;
} WSMAN_SHELL_STARTUP_INFO_V10;

Члены

inputStreamSet

Указатель на структуру WSMAN_STREAM_ID_SET , задающую набор входных потоков для оболочки. Потоки, отсутствуюте в фильтре, могут быть проигнорированы реализацией оболочки. Для оболочки Windows Cmd.exe это значение должно быть L"stdin". Если значение равно NULL, реализация использует массив с L"stdin" в качестве значения по умолчанию.

outputStreamSet

Указатель на структуру WSMAN_STREAM_ID_SET , задающую набор выходных потоков для оболочки. Потоки, отсутствуюте в фильтре, могут быть проигнорированы реализацией оболочки. Для оболочки windows cmd.exe это значение должно быть L"stdout stderr". Если значение равно NULL, реализация использует массив с L"stdout" и L"stderr" в качестве значения по умолчанию.

idleTimeoutMs

Указывает максимальную длительность (в миллисекундах) оболочка будет оставаться открытой без запроса клиента. При превышении максимальной длительности оболочка автоматически удаляется. Можно задать любое значение от 0 до 0xFFFFFFFF. Эта длительность имеет максимальное значение, указанное параметром объекта групповой политики времени ожидания простоя, если он включен, или локальной конфигурацией IdleTimeout. Значение по умолчанию максимальной длительности в объекте групповой политики или локальной конфигурации составляет 15 минут. Однако системный администратор может изменить это значение. Чтобы использовать максимальное значение из объекта групповой политики или локальной конфигурации, клиент должен указать в этом поле значение 0 (ноль). Если используется явное значение от 0 до 0xFFFFFFFF, используется минимальное значение между явным значением API и значением из объекта групповой политики или локальной конфигурации.

workingDirectory

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

variableSet

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

Требования

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