ITSGAuthenticationEngine：：AuthenticateUser 方法 (tsgauthenticationengine.h)
对用户进行身份验证。
远程桌面网关 (RD 网关) 在收到新的连接请求时调用此方法。 身份验证插件应基于 cookieData 参数引用的 Cookie 对用户进行身份验证。 然后，身份验证插件应使用 ITSGAuthenticateUserSink 接口通知 RD 网关身份验证结果。
语法
HRESULT AuthenticateUser(
[in] GUID mainSessionId,
[in] BYTE *cookieData,
[in] ULONG numCookieBytes,
[in] ULONG_PTR context,
[in] ITSGAuthenticateUserSink *pSink
);
参数
[in] mainSessionId
RD 网关分配给连接请求的唯一标识符。
[in] cookieData
指向包含用户提供的 Cookie 的 BYTE 的指针。
[in] numCookieBytes
cookieData 参数引用的字节数。
[in] context
指向 ULONG 的指针，其中包含特定于此连接的值。 此值应使用 ITSGAuthenticateUserSink 接口的方法传递回 RD 网关。
[in] pSink
指向 ITSGAuthenticateUserSink 接口的指针，身份验证插件必须使用该接口通知 RD 网关身份验证结果。
返回值
如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。
注解
如果此方法返回 S_OK，RD 网关将等待身份验证插件调用 ITSGAuthenticateUserSink 接口的方法。 如果返回任何其他值，RD 网关将立即拒绝连接请求。
有关使用 AuthenticateUser 方法的示例，请参阅 远程桌面网关可插入身份验证和授权 示例。
要求
| 最低受支持的客户端 | Windows 7 |
| 最低受支持的服务器 | Windows Server 2008 R2 |
| 目标平台 | Windows |
| 标头 | tsgauthenticationengine.h |