ITSGAuthorizeConnectionSink：：OnConnectionAuthorized 方法 (tsgpolicyengine.h)

通知远程桌面网关 (RD 网关) 尝试授权连接的结果。

语法

HRESULT OnConnectionAuthorized(
  [in] HRESULT                     hrIn,
  [in] GUID                        mainSessionId,
  [in] ULONG                       cbSoHResponse,
  [in] BYTE                        *pbSoHResponse,
  [in] ULONG                       idleTimeout,
  [in] ULONG                       sessionTimeout,
  [in] SESSION_TIMEOUT_ACTION_TYPE sessionTimeoutAction,
  [in] AATrustClassID              trustClass,
  [in] PolicyAttributes            policyAttributes
);

参数

[in] hrIn

授权尝试的结果。 指定 S_OK 以指示尝试成功。 指定任何其他值以指示尝试失败。

[in] mainSessionId

RD 网关分配给连接请求的唯一标识符。

[in] cbSoHResponse

pbSoHResponse 参数引用的字节数。

[in] pbSoHResponse

指向 BYTE 的指针，指定对 SoH) 运行状况声明 (请求的响应。 如果未S_OKhrIn 参数，则忽略此参数。

[in] idleTimeout

连接在断开连接之前可以保持空闲状态的分钟数。 如果未S_OKhrIn 参数，则忽略此参数。

[in] sessionTimeout

分配给会话的最大分钟数。 如果未S_OKhrIn 参数，则忽略此参数。

[in] sessionTimeoutAction

会话超时时要执行的操作。如果未S_OKhrIn 参数，则忽略此参数。 此参数的取值可为下列值之一：

SESSION_TIMEOUT_ACTION_DISCONNECT

断开会话的连接。

SESSION_TIMEOUT_ACTION_SILENT_REAUTH

以无提示方式重新进行身份验证并重新授权会话。

[in] trustClass

此参数为保留参数。 始终将其设置为 AA_TRUSTEDUSER_TRUSTEDCLIENT。 如果未S_OKhrIn 参数，则忽略此参数。

[in] policyAttributes

一个布尔值的数组，指定与连接关联的重定向设置。 数组的每个元素对应于 PolicyAttributeType 枚举的值。 如果未S_OKhrIn 参数，则忽略此参数。

返回值

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

注解

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

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

要求

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

另请参阅

ITSGAuthorizeConnectionSink