ITSGAuthenticateUserSink::OnUserAuthenticated 方法 (tsgauthenticationengine.h)

通知远程桌面网关 (RD 网关) 身份验证插件已成功对用户进行身份验证。

语法

HRESULT OnUserAuthenticated(
  [in]           BSTR       userName,
  [in]           BSTR       userDomain,
  [in]           ULONG_PTR  context,
  [in, optional] HANDLE_PTR userToken
);

参数

[in] userName

发起连接的用户的名称。

[in] userDomain

发起连接的用户的域。

[in] context

指向 ULONG 的指针,其中包含标识此连接的 值。 使用 AuthenticateUser 方法传递的值。

[in, optional] userToken

指向 HANDLE 的指针,该句柄指定用户的用户令牌。 如果用户未运行 Windows,请将此参数设置为 NULL

返回值

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

可以从 AuthenticateUser 的实现中调用此方法。 如果身份验证需要超过 1 秒,建议启动单独的线程来执行身份验证。

有关使用 OnUserAuthenticated 方法的示例,请参阅 远程桌面网关可插入身份验证和授权 示例。

要求

要求
最低受支持的客户端 Windows 7
最低受支持的服务器 Windows Server 2008 R2
目标平台 Windows
标头 tsgauthenticationengine.h

另请参阅

AuthenticateUser

ITSGAuthenticateUserSink