Fungsi WTSDisconnectSession (wtsapi32.h)

  • Artikel

Memutuskan sambungan pengguna yang masuk dari sesi Layanan Desktop Jauh yang ditentukan tanpa menutup sesi. Jika pengguna kemudian masuk ke server Host Sesi Desktop Jarak Jauh (Host Sesi RD) yang sama, pengguna akan terhubung kembali ke sesi yang sama.

Sintaks

BOOL WTSDisconnectSession(
  [in] HANDLE hServer,
  [in] DWORD  SessionId,
  [in] BOOL   bWait
);

Parameter

[in] hServer

Handel ke server Host Sesi RD. Tentukan handel yang dibuka oleh fungsi WTSOpenServer atau WTSOpenServerEx , atau tentukan WTS_CURRENT_SERVER_HANDLE untuk menunjukkan server Host Sesi RD tempat aplikasi Anda berjalan.

[in] SessionId

Pengidentifikasi sesi Layanan Desktop Jarak Jauh. Untuk menunjukkan sesi saat ini, tentukan WTS_CURRENT_SESSION. Untuk mengambil pengidentifikasi semua sesi di server Host Sesi RD tertentu, gunakan fungsi WTSEnumerateSessions .

Agar dapat memutuskan sambungan sesi pengguna lain, Anda harus memiliki izin Putuskan sambungan. Untuk informasi selengkapnya, lihat Izin Layanan Desktop Jauh. Untuk mengubah izin pada sesi, gunakan alat administratif Konfigurasi Layanan Desktop Jauh.

Untuk memutuskan sesi yang berjalan pada komputer virtual yang dihosting di server Host Virtualisasi RD, Anda harus menjadi anggota grup Administrator di server Host Virtualisasi RD.

[in] bWait

Menunjukkan apakah operasi sinkron. Tentukan TRUE untuk menunggu operasi selesai, atau FALSE segera kembali.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah nilai bukan nol.

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

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)

Lihat juga

WTSEnumerateSessions