Fungsi SetProcessShutdownParameters (processthreadsapi.h)

Artikel
03/08/2023

Mengatur parameter matikan untuk proses panggilan saat ini. Fungsi ini menetapkan urutan matikan untuk proses yang relatif terhadap proses lain dalam sistem.

Sintaks

BOOL SetProcessShutdownParameters(
  [in] DWORD dwLevel,
  [in] DWORD dwFlags
);

Parameter

[in] dwLevel

Prioritas matikan untuk proses relatif terhadap proses lain dalam sistem. Sistem mematikan proses dari nilai dwLevel tinggi ke rendah. Prioritas pematian tertinggi dan terendah dicadangkan untuk komponen sistem. Parameter ini harus dalam rentang nilai berikut.

Nilai	Makna
000-0FF	Rentang matikan terakhir yang dicadangkan sistem.
100-1FF	Rentang matikan terakhir yang dipesan aplikasi.
200-2FF	Aplikasi dicadangkan "di antara" rentang matikan.
300-3FF	Rentang matikan pertama yang dipesan aplikasi.
400-4FF	Rentang matikan pertama yang dipesan sistem.

Semua proses dimulai pada tingkat pematian 0x280.

[in] dwFlags

Parameter ini bisa menjadi nilai berikut.

Nilai	Makna
SHUTDOWN_NORETRY 0x00000001	Sistem mengakhiri proses tanpa menampilkan kotak dialog coba lagi untuk pengguna.

Menampilkan 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

Aplikasi yang berjalan dalam konteks keamanan sistem tidak dimatikan oleh sistem operasi. Mereka mendapatkan pemberitahuan tentang mematikan atau keluar melalui fungsi panggilan balik yang dapat diinstal melalui SetConsoleCtrlHandler. Mereka juga mendapatkan pemberitahuan dalam urutan yang ditentukan oleh parameter dwLevel .

Persyaratan


Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	processthreadsapi.h (termasuk Windows.h pada Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

GetProcessShutdownParameters

Fungsi Proses dan Utas

Proses

SetConsoleCtrlHandler

Bagikan melalui