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

Статья
08/28/2023

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

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

Синтаксис

WSMAN_PLUGIN_SHELL WsmanPluginShell;

void WsmanPluginShell(
  PVOID pluginContext,
  WSMAN_PLUGIN_REQUEST *requestDetails,
  DWORD flags,
  WSMAN_SHELL_STARTUP_INFO *startupInfo,
  WSMAN_DATA *inboundShellInformation
)
{...}

Параметры

pluginContext

Указывает контекст, возвращенный вызовом метода WSManPluginStartup . Этот параметр представляет собой инициализацию конкретного приложения подключаемого модуля WinRM.

requestDetails

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

flags

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

startupInfo

Указатель на структуру WSMAN_SHELL_STARTUP_INFO , содержащую сведения о запуске оболочки.

inboundShellInformation

Указатель на структуру WSMAN_DATA , указывающую необязательный входящий объект, содержащий дополнительные данные для оболочки.

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

None

Remarks

Подключаемый модуль WinRM (WinRM) вызывает WSManPluginReportContext для регистрации контекста оболочки для оболочки. Все операции с этой оболочкой передаются в этот контекст. Если оболочка завершила работу или подключаемый модуль проверяет параметр requestDetails и сообщает, что операция была отменена, подключаемый модуль должен вызвать WSManPluginOperationComplete. Все передаваемые параметры действительны до тех пор, пока подключаемый модуль 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)

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