Fungsi WlxInitialize (winwlx.h)

Artikel
03/08/2023

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

Fungsi WlxInitialize harus diimplementasikan oleh DLL GINA pengganti. Winlogon memanggil fungsi ini sekali untuk setiap stasiun jendela yang ada di komputer. Saat ini, sistem operasi mendukung satu stasiun jendela per stasiun kerja.

Catatan DLL GINA diabaikan di Windows Vista.

Konteks yang dikembalikan oleh fungsi ini akan diteruskan kembali ke GINA di semua panggilan berikutnya.

Sintaks

BOOL WlxInitialize(
  [in]  LPWSTR lpWinsta,
  [in]  HANDLE hWlx,
  [in]  PVOID  pvReserved,
  [in]  PVOID  pWinlogonFunctions,
  [out] PVOID  *pWlxContext
);

Parameter

[in] lpWinsta

Penunjuk ke nama stasiun jendela yang sedang diinisialisasi.

[in] hWlx

Sebuah handel untuk Winlogon. GINA harus menyediakan handel ini di semua panggilan ke fungsi dukungan Winlogon yang melibatkan stasiun jendela ini.

[in] pvReserved

Parameter ini dicadangkan untuk digunakan di masa mendatang dan harus diatur ke NULL.

[in] pWinlogonFunctions

Penunjuk ke tabel pengiriman fungsi dukungan Winlogon. Konten tabel bergantung pada versi DLL GINA yang dikembalikan oleh panggilan WlxNegotiate . Tabel ini tidak berubah, yang memungkinkan DLL GINA untuk mereferensikan tabel tanpa menyalinnya. Jika DLL GINA perlu membuat salinan tabel, itu harus memanggil WlxGetOption dan menyediakan WLX_OPTION_DISPATCH_TABLE_SIZE untuk parameter Opsi .

Nilai	Makna
WLX_DISPATCH_VERSION_1_4	Tabel pengiriman Winlogon - versi 1.4
WLX_DISPATCH_VERSION_1_3	Tabel pengiriman Winlogon - versi 1.3
WLX_DISPATCH_VERSION_1_2	Tabel pengiriman Winlogon - versi 1.2
WLX_DISPATCH_VERSION_1_1	Tabel Winlogondispatch - versi 1.1
WLX_DISPATCH_VERSION_1_0	Tabel pengiriman Winlogon - versi 1.0

[out] pWlxContext

Pointer ke pointer ke VOID yang akan berisi alamat konteks GINA untuk stasiun jendela ini. Konteks ini diteruskan dalam semua panggilan berikutnya ke GINA dari Winlogon. DLL GINA mengelola memori apa pun yang digunakan oleh konteks. Penunjuk konteks dapat diubah nanti dengan memanggil fungsi WlxSetOption dengan WLX_OPTION_CONTEXT_POINTER.

Nilai kembali

Jika fungsi berhasil menginisialisasi DLL GINA, fungsi mengembalikan TRUE.

Jika fungsi gagal, atau jika DLL GINA tidak diinisialisasi, fungsi mengembalikan FALSE. Winlogon akan berakhir, dan sistem tidak akan boot.

Keterangan

WlxInitialize dipanggil sekali untuk setiap stasiun jendela yang ada di komputer.

Saat ini hanya satu stasiun jendela yang disebut Winsta0 yang didukung.

Sebelum memanggil WlxInitialize, Winlogon mengatur status desktop sehingga desktop saat ini adalah desktop Winlogon dan mengatur status stasiun kerja sehingga desktop terkunci.

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

WlxNegotiate