WSMAN_PLUGIN_AUTHORIZE_USER回调函数 (wsman.h)

授权连接。 插件应验证是否允许此用户执行任何操作。 如果允许用户执行操作,则插件必须报告成功。 如果不允许用户执行任何类型的操作,则必须返回失败。

无需对每个新连接进行授权。 授权用户进行连接后,将创建用户记录来跟踪用户的活动。 当该记录存在时,所有新连接将自动获得授权。 未检测到任何活动后,用户记录将在可配置的时间量后超时。

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

语法

WSMAN_PLUGIN_AUTHORIZE_USER WsmanPluginAuthorizeUser;

void WsmanPluginAuthorizeUser(
  [in] PVOID pluginContext,
  [in] WSMAN_SENDER_DETAILS *senderDetails,
  [in] DWORD flags
)
{...}

参数

[in] pluginContext

指定调用 WSManPluginStartup 返回的上下文。 此参数表示 WinRM 插件的特定应用程序初始化。

[in] senderDetails

指向 WSMAN_SENDER_DETAILS 结构的指针,该结构指定要授权的用户的标识信息。

[in] flags

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

返回值

备注

插件必须调用 WSManPluginAuthzUserComplete ,以报告用户已成功获得 NO_ERROR 授权,或者用户未获得 ERROR_ACCESS_DENIED授权。 如果此用户需要 HTTP 重定向,则应报告ERROR_WSMAN_REDIRECT_REQUIRED错误,并且新的 HTTP URI 应记录在 WSManPluginAuthzUserComplete 方法的 extendedErrorInformation 中。 所有其他错误向客户端报告失败,但不报告任何特定信息。

要求

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