通过

WSMAN_PLUGIN_SIGNAL回调函数 (wsman.h)

  • 项目

定义插件的信号回调。 当从客户端调用接收入站信号时，将调用此函数。

此方法的 DLL 入口点名称必须为 WSManPluginSignal。

语法

WSMAN_PLUGIN_SIGNAL WsmanPluginSignal;

void WsmanPluginSignal(
  [in]           WSMAN_PLUGIN_REQUEST *requestDetails,
  [in]           DWORD flags,
  [in]           PVOID shellContext,
  [in, optional] PVOID commandContext,
  [in]           PCWSTR code
)
{...}

参数

[in] requestDetails

指向 WSMAN_PLUGIN_REQUEST 结构的指针，该结构指定请求的资源 URI、选项、区域设置、关闭标志和句柄。

[in] flags

保留供将来使用。 必须为零。

[in] shellContext

指定创建 shell 时收到的上下文。

[in, optional] commandContext

如果此请求针对的是命令而不是 shell，则这是从 winrm 创建 操作返回的上下文;否则，此参数为 NULL。

[in] code

指定从客户端接收的信号。 以下代码很常见。

WSMAN_SIGNAL_SHELL_CODE_TERMINATE

shell 或命令提示符窗口已关闭。 插件应调用 WSManPluginOperationComplete 函数。

WSMAN_SIGNAL_SHELL_CODE_CTRL_C

已收到 CTRL+C 的信号，并且进程已停止。 插件应调用 WSManPluginOperationComplete 函数。

WSMAN_SIGNAL_SHELL_CODE_CTRL_BREAK

收到 CTRL+BREAK 的信号，进程已停止。 插件应调用 WSManPluginOperationComplete 函数。

返回值

无

备注

可以接收用于处理 CTRL+C 序列或许多其他类型的自定义信号之一的信号。 对于收到的每个信号，回调调用一次。 插件确定哪些信号会导致命令和/或 shell 关闭。 由于信号特定于 shell，因此插件必须通过调用 WSManPluginOperationComplete 方法启动关闭。 对于每个调用，插件应调用 WSManPluginOperationComplete 来确认接收，并允许接收下一个信号。

要求

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