共用方式為

ITSGPolicyEngine：：AuthorizeConnection 方法 (tsgpolicyengine.h)

  • 發行項

判斷指定的連線是否獲授權連線到遠端桌面閘道 (RD 閘道) 。

RD 閘道會在使用者成功驗證之後呼叫此方法。 授權外掛程式應該接著使用 ITSGAuthorizeConnectionSink 介面來通知 RD 閘道有關授權的結果。

語法

HRESULT AuthorizeConnection(
  [in] GUID                        mainSessionId,
  [in] BSTR                        username,
  [in] AAAuthSchemes               authType,
  [in] BSTR                        clientMachineIP,
  [in] BSTR                        clientMachineName,
  [in] BYTE                        *sohData,
  [in] ULONG                       numSOHBytes,
  [in] BYTE                        *cookieData,
  [in] ULONG                       numCookieBytes,
  [in] HANDLE_PTR                  userToken,
  [in] ITSGAuthorizeConnectionSink *pSink
);

參數

[in] mainSessionId

由 RD 閘道指派給連線要求的唯一識別碼。

[in] username

使用者名稱。

[in] authType

AAAuthSchemes列舉類型的值，指定用來連線到 RD 閘道的驗證類型。

[in] clientMachineIP

使用者電腦的 IP 位址。

[in] clientMachineName

使用者電腦的名稱。

[in] sohData

BYTE的指標，其中包含使用者電腦所提供的健全狀況 (SoH) 語句。 如果授權外掛程式不需要健全狀況的語句，則此參數為 Null。 如需詳細資訊，請參閱 IsQuarantineEnabled 方法。

[in] numSOHBytes

sohData參數所參考的位元組數目。

[in] cookieData

BYTE的指標，其中包含使用者提供的 Cookie。 如果 authType 參數未設定為 AA_AUTH_COOKIE，則此參數為 Null。

[in] numCookieBytes

cookieData參數所參考的位元組數目。

[in] userToken

HANDLE的指標，指定使用者的使用者權杖。 如果使用者未執行 Windows，則此參數為 Null。

[in] pSink

ITSGAuthorizeConnectionSink介面的指標，授權外掛程式必須用來通知 RD 閘道有關授權的結果。

傳回值

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

如果此方法傳回 S_OK，RD 閘道會等候授權外掛程式呼叫 ITSGAuthorizeConnectionSink 介面的 方法。 如果傳回任何其他值，RD 閘道會立即拒絕授權要求。

如果授權需要超過 1 秒，建議您啟動個別執行緒來執行授權。

如需使用 AuthorizeConnection 方法的範例，請參閱 遠端桌面閘道插入式驗證和授權 範例。

規格需求

   
最低支援的用戶端 Windows 7
最低支援的伺服器 Windows Server 2008 R2
目標平台 Windows
標頭 tsgpolicyengine.h

另請參閱

ITSGAuthorizeConnectionSink

ITSGPolicyEngine

IsQuarantineEnabled