Fungsi AbortSystemShutdownA (winreg.h)

Menghentikan pematian sistem yang telah dimulai.

Sintaks

BOOL AbortSystemShutdownA(
  [in, optional] LPSTR lpMachineName
);

Parameter

[in, optional] lpMachineName

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

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

Fungsi InitiateSystemShutdown dan InitiateSystemShutdownEx menampilkan kotak dialog yang memberi tahu pengguna bahwa sistem dimatikan. Selama periode waktu matikan, 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 matikan 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 pemanggilan 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.

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 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

Persyaratan	Nilai
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 Matikan Sistem