共用方式為

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

BYTE的指標，其中包含使用者提供的 Cookie。

[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

另請參閱

ITSGAuthenticationEngine