WSMAN_PLUGIN_SHUTDOWN回调函数 (wsman.h)

定义插件的关闭回调。 在取消所有操作后,在卸载 Windows 远程管理插件 DLL 之前调用此函数。 所有 WinRM 插件都必须实现此回调函数。

DLL 入口点名称必须为 WSManPluginShutdown

语法

WSMAN_PLUGIN_SHUTDOWN WsmanPluginShutdown;

DWORD WsmanPluginShutdown(
  PVOID pluginContext,
  DWORD flags,
  DWORD reason
)
{...}

参数

pluginContext

指定调用 WSManPluginStartup 方法返回的上下文。 此参数表示 WinRM 插件的特定应用程序初始化。 将为初始化它的每个应用程序调用关闭入口点。

flags

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

reason

指定插件关闭的原因。

WSMAN_PLUGIN_SHUTDOWN_SYSTEM

系统关闭。

WSMAN_PLUGIN_SHUTDOWN_SERVICE

WinRM 服务关闭。

WSMAN_PLUGIN_SHUTDOWN_IISHOST

IIS 主机关闭。

返回值

如果成功,该方法将返回 NO_ERROR ;否则,它将返回错误代码。

注意 如果此方法失败,插件将不会重新调用。
 

注解

每次成功调用 WSManPluginStartup 将导致在卸载 WinRM 插件 DLL 之前调用此函数。 请务必确保 WinRM 插件跟踪调用此启动入口点的次数,以便插件不会过早关闭。

此函数必须确保在返回之前关闭所有插件线程。 如果插件仅处理同步操作,并且所有线程在返回前都报告取消结果,则此函数仅执行插件清理。 但是,对于异步插件,任何用于处理插件线程的线程(包括刚报告所有操作取消的线程)都需要完全关闭。 如果未关闭所有线程,则 DLL 中可能发生崩溃,因为代码可能在 DLL 卸载后执行。

要求

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