Fungsi WlxActivateUserShell (winwlx.h)

Artikel
08/28/2023

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

Mengaktifkan program shell pengguna.

Fungsi WlxActivateUserShell harus diimplementasikan oleh DLL GINA pengganti. Winlogon memanggil fungsi ini setelah berhasil masuk untuk meminta AGAR GINA mengaktifkan program shell pengguna.

Catatan DLL GINA diabaikan di Windows Vista.

Sintaks

BOOL WlxActivateUserShell(
  [in] PVOID pWlxContext,
  [in] PWSTR pszDesktopName,
  [in] PWSTR pszMprLogonScript,
  [in] PVOID pEnvironment
);

Parameter

[in] pWlxContext

Penunjuk ke konteks GINA yang terkait dengan stasiun jendela ini. Ini adalah nilai konteks yang dikembalikan GINA ketika Winlogon memanggil WlxInitialize untuk stasiun ini.

[in] pszDesktopName

Penunjuk ke string karakter lebar yang dihentikan null yang menentukan nama desktop tempat shell akan dimulai. Teruskan string ini ke fungsi CreateProcess atau CreateProcessAsUser melalui anggota lpDesktop dari struktur STARTUPINFO .

[in] pszMprLogonScript

Penunjuk ke string karakter lebar yang dihentikan null yang menentukan nama skrip apa pun yang dikembalikan dari DLL penyedia jaringan. DLL penyedia jaringan dapat mengembalikan skrip yang akan dijalankan selama masuk; namun, GINA dapat mengabaikannya.

[in] pEnvironment

Menentukan variabel lingkungan awal untuk proses tersebut. Winlogon membuat salinan lingkungan dan menyerahkannya ke GINA. GINA dapat memodifikasi lingkungan ini sebelum menggunakannya untuk menginisialisasi shell pengguna. GINA harus memanggil fungsi VirtualFree untuk membebaskan memori yang dialokasikan untuk pEnvironment.

Mengembalikan nilai

Jika fungsi berhasil memulai proses shell, fungsi mengembalikan TRUE.

Jika fungsi gagal, fungsi akan mengembalikan FALSE. Ketika FALSE dikembalikan, Winlogon membatalkan proses masuk.

Keterangan

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

Selalu aktifkan program shell pengguna di WlxActivateUserShell daripada WlxLoggedOutSAS. Ini memberi Winlogon kesempatan untuk memperbarui statusnya, termasuk mengatur stasiun kerja dan perlindungan desktop, sebelum proses pengguna yang masuk diizinkan untuk berjalan.

Persyaratan


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

WlxInitialize

WlxLoggedOutSAS

WlxLogoff