Fungsi WTSRegisterSessionNotification (wtsapi32.h)

Artikel
08/28/2023

Mendaftarkan jendela yang ditentukan untuk menerima pemberitahuan perubahan sesi.

Sintaks

BOOL WTSRegisterSessionNotification(
  [in] HWND  hWnd,
  [in] DWORD dwFlags
);

Parameter

[in] hWnd

Tangani jendela untuk menerima pemberitahuan perubahan sesi.

[in] dwFlags

Menentukan pemberitahuan sesi mana yang akan diterima. Parameter ini bisa menjadi salah satu nilai berikut.

NOTIFY_FOR_THIS_SESSION

Hanya pemberitahuan sesi yang melibatkan sesi yang dilampirkan oleh jendela yang diidentifikasi oleh nilai parameter hWnd yang akan diterima.

NOTIFY_FOR_ALL_SESSIONS

Semua pemberitahuan sesi akan diterima.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah TRUE. Jika tidak, itu adalah FALSE. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Jika fungsi ini dipanggil sebelum layanan dependen Layanan Desktop Jauh dimulai, kode kesalahan RPC_S_INVALID_BINDING dapat dikembalikan. Ketika peristiwa global Global\TermSrvReadyEvent diatur, semua layanan dependen telah dimulai dan fungsi ini dapat berhasil dipanggil.

Pemberitahuan perubahan sesi dikirim dalam bentuk pesan WM_WTSSESSION_CHANGE . Pemberitahuan ini dikirim hanya ke jendela yang telah mendaftarkannya menggunakan fungsi ini.

Ketika jendela tidak lagi memerlukan pemberitahuan ini, jendela harus memanggil WTSUnRegisterSessionNotification sebelum dihancurkan. Untuk setiap panggilan ke fungsi ini, harus ada panggilan yang sesuai ke WTSUnRegisterSessionNotification.

Jika handel jendela yang diteruskan dalam fungsi ini sudah terdaftar, nilai parameter dwFlags diabaikan.

Untuk menerima pemberitahuan perubahan sesi dari layanan, gunakan fungsi HandlerEx .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Target Platform	Windows
Header	wtsapi32.h
Pustaka	Wtsapi32.lib
DLL	Wtsapi32.dll
Set API	ext-ms-win-session-wtsapi32-l1-1-0 (diperkenalkan dalam Windows 8)