функция обратного вызова WSMAN_PLUGIN_RECEIVE (wsman.h)

2023-08-28

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

Имя точки входа DLL должно быть WSManPluginReceive.

Синтаксис

WSMAN_PLUGIN_RECEIVE WsmanPluginReceive;

void WsmanPluginReceive(
  WSMAN_PLUGIN_REQUEST *requestDetails,
  DWORD flags,
  PVOID shellContext,
  PVOID commandContext,
  WSMAN_STREAM_ID_SET *streamSet
)
{...}

Параметры

requestDetails

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

flags

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

shellContext

Указывает контекст, полученный при создании оболочки.

commandContext

Если этот запрос предназначен для команды, а не оболочки, это контекст, возвращаемый операцией создания winrm ; В противном случае этот параметр имеет значение NULL.

streamSet

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

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

None

Remarks

В зависимости от запроса клиента функцию обратного вызова WSMAN_PLUGIN_RECEIVE можно вызвать для оболочки и (или) команды . Подключаемый модуль вызывает метод WSManPluginReceiveResult для каждого фрагмента данных, который необходимо отправить обратно клиенту. После отправки всех данных подключаемый модуль вызывает WSManPluginOperationComplete , чтобы завершить поток. Все передаваемые параметры действительны до тех пор, пока подключаемый модуль удаленного управления Windows (WinRM) не вызовет WSManPluginOperationComplete.

Требования


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