Fungsi CreateWindowStationA (winuser.h)

Membuat objek stasiun jendela, mengaitkannya dengan proses panggilan, dan menetapkannya ke sesi saat ini.

Sintaks

HWINSTA CreateWindowStationA(
  [in, optional] LPCSTR                lpwinsta,
                 DWORD                 dwFlags,
  [in]           ACCESS_MASK           dwDesiredAccess,
  [in, optional] LPSECURITY_ATTRIBUTES lpsa
);

Parameter

[in, optional] lpwinsta

Nama stasiun jendela yang akan dibuat. Nama stasiun jendela tidak peka huruf besar/kecil dan tidak boleh berisi karakter garis miring terbelakang (\). Hanya anggota grup Administrator yang diizinkan untuk menentukan nama. Jika lpwinstaadalah NULL atau string kosong, sistem membentuk nama stasiun jendela menggunakan pengidentifikasi sesi masuk untuk proses panggilan. Untuk mendapatkan nama ini, panggil fungsi GetUserObjectInformation .

dwFlags

Jika parameter ini CWF_CREATE_ONLY dan stasiun jendela sudah ada, panggilan gagal. Jika bendera ini tidak ditentukan dan stasiun jendela sudah ada, fungsi berhasil dan mengembalikan handel baru ke stasiun jendela yang ada.

Windows XP/2000: Parameter ini dicadangkan dan harus nol.

[in] dwDesiredAccess

Jenis akses handel yang dikembalikan harus ke stasiun jendela. Selain itu, Anda dapat menentukan salah satu hak akses standar, seperti READ_CONTROL atau WRITE_DAC, dan kombinasi hak akses khusus stasiun jendela. Untuk informasi selengkapnya, lihat Keamanan dan Hak Akses Window Station.

[in, optional] lpsa

Penunjuk ke struktur SECURITY_ATTRIBUTES yang menentukan apakah handel yang dikembalikan dapat diwariskan oleh proses anak. Jika lpsaNULL, handel tidak dapat diwariskan.

Anggota lpSecurityDescriptor dari struktur menentukan deskriptor keamanan untuk stasiun jendela baru. Jika lpsaadalah NULL, stasiun jendela (dan desktop apa pun yang dibuat di dalam jendela) mendapatkan deskriptor keamanan yang memberikan akses GENERIC_ALL ke semua pengguna.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah handel ke stasiun jendela yang baru dibuat. Jika stasiun jendela yang ditentukan sudah ada, fungsi berhasil dan mengembalikan handel ke stasiun jendela yang ada.

Jika fungsi gagal, nilai yang dikembalikan adalah NULL. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Setelah selesai menangani, Anda harus memanggil CloseWindowStation untuk membebaskan handel.

Catatan

Header winuser.h mendefinisikan CreateWindowStation sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	winuser.h (sertakan Windows.h)
Pustaka	User32.lib
DLL	User32.dll
Set API	ext-ms-win-ntuser-windowstation-l1-1-0 (diperkenalkan di Windows 8)

Lihat juga

CloseWindowStation

GetUserObjectInformation

OpenWindowStation

Stasiun Jendela dan Fungsi Desktop

Stasiun Jendela