METODE ITSGAuthenticationEngine::AuthenticateUser (tsgauthenticationengine.h)

Mengautentikasi pengguna.

Gateway Desktop Jarak Jauh (Gateway RD) memanggil metode ini saat menerima permintaan koneksi baru. Plug-in autentikasi harus mengautentikasi pengguna berdasarkan cookie yang dirujuk oleh parameter cookieData . Plug-in autentikasi kemudian harus menggunakan antarmuka ITSGAuthenticateUserSink untuk memberi tahu RD Gateway tentang hasil autentikasi.

Sintaks

HRESULT AuthenticateUser(
  [in] GUID                     mainSessionId,
  [in] BYTE                     *cookieData,
  [in] ULONG                    numCookieBytes,
  [in] ULONG_PTR                context,
  [in] ITSGAuthenticateUserSink *pSink
);

Parameter

[in] mainSessionId

Pengidentifikasi unik yang ditetapkan ke permintaan koneksi oleh RD Gateway.

[in] cookieData

Penunjuk ke BYTE yang berisi cookie yang disediakan oleh pengguna.

[in] numCookieBytes

Jumlah byte yang dirujuk oleh parameter cookieData .

[in] context

Penunjuk ke ULONG yang berisi nilai khusus untuk koneksi ini. Nilai ini harus diteruskan kembali ke Gateway RD dengan menggunakan metode antarmuka ITSGAuthenticateUserSink .

[in] pSink

Penunjuk ke antarmuka ITSGAuthenticateUserSink yang harus digunakan plug-in autentikasi untuk memberi tahu RD Gateway tentang hasil autentikasi.

Mengembalikan nilai

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Jika metode ini mengembalikan S_OK, RD Gateway menunggu plug-in autentikasi untuk memanggil metode antarmuka ITSGAuthenticateUserSink . Jika ada nilai lain yang dikembalikan, RD Gateway segera menolak permintaan koneksi.

Untuk sampel yang menggunakan metode AuthenticateUser , lihat sampel Autentikasi dan Otorisasi Pluggable Gateway Desktop Jarak Jauh .

Persyaratan

Klien minimum yang didukung	Windows 7
Server minimum yang didukung	Windows Server 2008 R2
Target Platform	Windows
Header	tsgauthenticationengine.h

Lihat juga

ITSGAuthenticationEngine