Fungsi AbortSystemShutdownW (winreg.h)

Menghentikan pematian sistem yang telah dimulai.

Sintaks

BOOL AbortSystemShutdownW(
  [in, optional] LPWSTR lpMachineName
);

Parameter

[in, optional] lpMachineName

Nama jaringan komputer tempat matikan akan dihentikan. Jika lpMachineName adalah NULL atau string kosong, fungsi akan menghentikan pematian di komputer lokal.

Mengembalikan nilai

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

Fungsi InitiateSystemShutdown dan InitiateSystemShutdownEx menampilkan kotak dialog yang memberi tahu pengguna bahwa sistem dimatikan. Selama periode waktu matikan habis, fungsi AbortSystemShutdown dapat mencegah sistem dimatikan.

Windows Server 2003 dan Windows XP dengan SP1: Jika komputer yang akan dimatikan adalah server Layanan Terminal, sistem menampilkan kotak dialog untuk semua pengguna lokal dan jarak jauh yang memperingatkan mereka bahwa pematian telah dimulai. Jika pematian dicegah oleh AbortSystemShutdown, sistem menampilkan kotak dialog kepada pengguna yang memberi tahu mereka bahwa server tidak lagi dimatikan.

Untuk menghentikan komputer lokal dimatikan, proses panggilan harus memiliki hak istimewa SE_SHUTDOWN_NAME. Untuk menghentikan komputer jarak jauh dimatikan, proses panggilan harus memiliki hak istimewa SE_REMOTE_SHUTDOWN_NAME pada komputer jarak jauh. Secara default, pengguna dapat mengaktifkan hak istimewa SE_SHUTDOWN_NAME pada komputer tempat mereka masuk, dan administrator dapat mengaktifkan hak istimewa SE_REMOTE_SHUTDOWN_NAME pada komputer jarak jauh. Untuk informasi selengkapnya, lihat Menjalankan dengan Hak Istimewa Khusus.

Alasan umum kegagalan termasuk nama komputer yang tidak valid, komputer yang tidak dapat diakses, atau hak istimewa yang tidak mencukupi.

Contoh

Misalnya, lihat Menampilkan Kotak Dialog Matikan.

Catatan

Header winreg.h mendefinisikan AbortSystemShutdown sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosem 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 XP [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	winreg.h (termasuk Windows.h)
Pustaka	Advapi32.lib
DLL	Advapi32.dll

Lihat juga

InitiateSystemShutdown

Mematikan

Fungsi Pematian Sistem