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

Статья
08/28/2023

Сообщает результаты вызова подключаемого модуля WSMAN_PLUGIN_RECEIVE и используется большинством подключаемых модулей оболочки, возвращающих результаты. После получения всех данных необходимо вызвать метод WSManPluginOperationComplete .

Синтаксис

DWORD WSManPluginReceiveResult(
  [in]           WSMAN_PLUGIN_REQUEST *requestDetails,
  [in]           DWORD                flags,
  [in, optional] PCWSTR               stream,
  [in, optional] WSMAN_DATA           *streamResult,
  [in, optional] PCWSTR               commandState,
  [in]           DWORD                exitCode
);

Параметры

[in] requestDetails

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

[in] flags

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

[in, optional] stream

Указывает поток, с которым связаны данные. Можно использовать любой поток, но стандартными потоками являются STDIN, STDOUT и STDERR.

[in, optional] streamResult

Указатель на структуру WSMAN_DATA , указывающую объект результата, возвращаемый клиенту. Результат может быть в двоичном или XML-формате.

[in, optional] commandState

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

WSMAN_RECEIVE_STATE_NONE

Операция не требует никаких действий.

WSMAN_RECEIVE_STATE_NORMAL_TERMINATION

Операция была завершена обычным образом.

WSMAN_RECEIVE_STATE_ABNORMAL_TERMINATION

Операция была неожиданно завершена.

WSMAN_RECEIVE_STATE_WAITING

Операция ожидает ввода.

WSMAN_RECEIVE_STATE_INPUT_REQUIRED

Операция требует ввода из командной строки.

[in] exitCode

Игнорируется во всех случаях, кроме случаев, когда commandState имеет значение WSMAN_RECEIVE_STATE_NORMAL_TERMINATION или WSMAN_RECEIVE_STATE_ABNORMAL_TERMINATION. Каждый результат может иметь отдельные коды ошибок. В случае сбоя команды или потока подключаемый модуль должен вызвать метод WSManPluginOperationComplete .

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

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)

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