PWLX_QUERY_CLIENT_CREDENTIALS fungsi panggilan balik (winwlx.h)

  • Artikel

[Fungsi WlxQueryClientCredentials tidak lagi tersedia untuk digunakan pada Windows Server 2008 dan Windows Vista.]

Fungsi WlxQueryClientCredentials dipanggil oleh DLL GINA pengganti jika Layanan Terminal diaktifkan.

Catatan DLL GINA diabaikan di Windows Vista.
 
GINA memanggil fungsi ini untuk mengambil kredensial klien Layanan Terminal jarak jauh yang tidak menggunakan lisensi konektor Internet.

DLL GINA dapat menggunakan informasi ini untuk mengisi kotak masuk secara otomatis dan mencoba memasukkan pengguna.

Sintaks

PWLX_QUERY_CLIENT_CREDENTIALS PwlxQueryClientCredentials;

BOOL PwlxQueryClientCredentials(
  [out] PWLX_CLIENT_CREDENTIALS_INFO_V1_0 pCred
)
{...}

Parameter

[out] pCred

Menentukan penunjuk ke struktur WLX_CLIENT_CREDENTIALS_INFO_V1_0 yang berisi kredensial klien yang dikembalikan.

Mengembalikan nilai

Fungsi WlxQueryClientCredentials mengembalikan salah satu nilai berikut.

Menampilkan kode Deskripsi
TRUE
 Informasi kredensial diambil dan dikembalikan dalam pCred.
FALSE
 Informasi kredensial tidak diambil.

Keterangan

DLL GINA bertanggung jawab untuk memanggil LocalFree untuk membebaskan sumber daya yang digunakan oleh struktur ini ketika struktur tidak lagi diperlukan.

Untuk mengakses fungsi ini, DLL GINA harus menggunakan struktur WLX_DISPATCH_VERSION_1_3 , dan mengatur versi Winlogon ke setidaknya WLX_VERSION_1_3 dalam panggilan WlxNegotiate-nya .

Jika klien Layanan Terminal menggunakan lisensi konektor Internet, DLL GINA harus memanggil WlxQueryInetConnectorCredentials.

Fungsi dukungan Winlogon lainnya yang mungkin dipanggil ketika Layanan Terminal diaktifkan adalah WlxDisconnect, WlxQueryInetConnectorCredentials, dan WlxWin31Migrate.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header winwlx.h

Lihat juga

WLX_DISPATCH_VERSION_1_3

WlxDisconnect

WlxNegotiate

WlxQueryInetConnectorCredentials

WlxWin31Migrate