WSMAN_PLUGIN_STARTUP回调函数 (wsman.h)

  • 项目

定义插件的启动回调。 由于多个应用程序可以托管在同一进程中，因此此方法可以多次调用，但每次应用程序初始化只能调用一次。 插件可以在同一进程中多次初始化，但每个 applicationIdentification 值只能初始化一次。 从此方法返回的上下文应特定于应用程序。 返回的上下文将传递到特定于应用程序的所有未来插件调用中。 所有 Windows 远程管理 (WinRM) 插件都必须实现此回调函数。

此方法的 DLL 入口点名称必须是 WSManPluginStartup。

语法

WSMAN_PLUGIN_STARTUP WsmanPluginStartup;

DWORD WsmanPluginStartup(
  DWORD flags,
  PCWSTR applicationIdentification,
  PCWSTR extraInfo,
  PVOID *pluginContext
)
{...}

参数

flags

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

applicationIdentification

托管应用程序的唯一标识符。 对于main WinRM 服务，默认值为 wsman。 对于 Internet Information Services (IIS) 主机，此标识符与该主机的应用程序终结点相关。 例如 ，wsman/MyCompany/MyApplication。

extraInfo

一个字符串，包含配置信息（如果在注册插件时存储了任何信息）。 使用 WinRM 配置注册插件时，该插件可以添加在初始化期间对可选节点有用的额外配置参数。 如果插件用于不同的 IIS 托管方案，并且初始化期间需要略有不同的运行时语义，则此信息特别有用。 此字符串是配置中的 XML 的副本（如果存在）。 否则，此参数设置为 NULL。

pluginContext

特定应用程序初始化的上下文。 此上下文将传递到与此 applicationIdentifier 关联的所有其他 WinRM 插件调用。

返回值

如果成功，该方法将返回 NO_ERROR ;否则，它将返回错误代码。 如果此方法返回错误，则不会调用 WSManPluginShutdown 入口点。

要求

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