Fungsi WlxActivateUserShell (winwlx.h)
[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.
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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk