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 |