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