WSMAN_PLUGIN_SHELL回调函数 (wsman.h)

  • 项目

定义插件的 shell 回调。 当收到新 shell 的请求时，将调用此函数。 支持 shell 操作的所有 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

指向包含 shell 启动信息的 WSMAN_SHELL_STARTUP_INFO 结构的指针。

inboundShellInformation

指向 WSMAN_DATA 结构的指针，该结构指定包含 shell 额外数据的可选入站对象。

返回值

无

备注

WinRM (WinRM) 插件调用 WSManPluginReportContext 来注册 shell 的 shell 上下文。 此 shell 上的所有操作都会传入此上下文。 如果 shell 已关闭或插件检查 requestDetails 参数并报告操作已取消，则插件应调用 WSManPluginOperationComplete。 传入的所有参数在 WinRM 插件调用 WSManPluginOperationComplete 之前都有效。

要求

要求 值
最低受支持的客户端 Windows 7
最低受支持的服务器 Windows Server 2008 R2
目标平台 Windows
标头 wsman.h
可再发行组件 在 Windows Server 2008 SP2、Windows Vista SP1 和 Windows Vista SP2 上Windows Management Framework