Fungsi WTSShutdownSystem (wtsapi32.h)

  • Artikel

Mematikan (dan secara opsional menghidupkan ulang) server Host Sesi Desktop Jarak Jauh (Host Sesi RD) yang ditentukan.

Untuk mematikan atau memulai ulang sistem, proses panggilan harus mengaktifkan hak istimewa SE_SHUTDOWN_NAME . Untuk informasi selengkapnya tentang hak istimewa keamanan, lihat Hak Istimewa dan Konstanta Otorisasi.

Sintaks

BOOL WTSShutdownSystem(
  [in] HANDLE hServer,
  [in] DWORD  ShutdownFlag
);

Parameter

[in] hServer

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

[in] ShutdownFlag

Menunjukkan jenis pematian. Parameter ini bisa menjadi salah satu nilai berikut.

WTS_WSD_LOGOFF

Memaksa semua sesi klien untuk keluar (kecuali sesi yang memanggil WTSShutdownSystem) dan menonaktifkan masuk jarak jauh berikutnya. Ini dapat digunakan sebagai langkah sebelum mematikan. Logon akan diaktifkan kembali ketika layanan Layanan Desktop Jarak Jauh dimulai ulang.

Gunakan nilai ini hanya pada konsol Layanan Desktop Jauh.

WTS_WSD_POWEROFF

Mematikan sistem pada server Host Sesi RD dan, pada komputer yang mendukung kontrol perangkat lunak daya AC, mematikan daya. Ini setara dengan memanggil ExitWindowsEx dengan EWX_SHUTDOWN dan EWX_POWEROFF. Proses panggilan harus mengaktifkan hak istimewa SE_SHUTDOWN_NAME .

WTS_WSD_REBOOT

Matikan lalu hidupkan ulang sistem di server Host Sesi RD. Ini setara dengan memanggil ExitWindowsEx dengan EWX_REBOOT. Proses panggilan harus mengaktifkan hak istimewa SE_SHUTDOWN_NAME .

WTS_WSD_SHUTDOWN

Mematikan sistem pada server Host Sesi RD. Ini setara dengan memanggil fungsi ExitWindowsEx dengan EWX_SHUTDOWN. Proses panggilan harus mengaktifkan hak istimewa SE_SHUTDOWN_NAME .

WTS_WSD_FASTREBOOT

Nilai ini tidak didukung saat ini.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

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

Keterangan

Pematian sistem mengakhiri semua pengguna dan program aktif. Langkah-langkah berikut terjadi selama pematian.

  1. Perintah keluar dikeluarkan untuk semua aplikasi pengguna aktif.
  2. Jika aplikasi tidak keluar dalam interval tertentu, aplikasi akan dihentikan.
  3. Setelah semua aplikasi untuk pengguna dihentikan, pengguna akan keluar.
  4. Setelah semua pengguna keluar, perintah keluar dikeluarkan untuk semua layanan sistem.
  5. Jika layanan sistem tidak berakhir dalam interval tertentu, layanan akan dihentikan.
  6. Cache sistem file ditulis ke disk.
  7. Disk ditandai sebagai baca-saja.
  8. Server Host Sesi RD menampilkan pesan "Sekarang aman untuk mematikan komputer Anda", atau sistem dimulai ulang jika WTS_WSD_REBOOT ditentukan. (Pesan ditampilkan di konsol karena semua sesi klien telah dihentikan.)
Catatan Karena mungkin ada banyak pengguna dan proses dalam konfigurasi multi-pengguna yang besar, konfigurasi sistem besar mungkin membutuhkan waktu untuk dimatikan secara teratur. Penting untuk memungkinkan sistem dimatikan sepenuhnya.
 
Windows Server 2008 dan Windows Vista: Panggilan ke WTSShutdownSystem tidak berfungsi ketika Remote Pengelola Sambungan (RCM) dinonaktifkan. Ini adalah kasus ketika layanan Layanan Desktop Jarak Jauh dihentikan.

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

Lihat juga

ExitWindowsEx