Fungsi ShutdownBlockReasonCreate (winuser.h)

Menunjukkan bahwa sistem tidak dapat dimatikan dan mengatur string alasan untuk ditampilkan kepada pengguna jika pematian sistem dimulai.

Sintaks

BOOL ShutdownBlockReasonCreate(
  [in] HWND    hWnd,
  [in] LPCWSTR pwszReason
);

Parameter

[in] hWnd

Handel ke jendela utama aplikasi.

[in] pwszReason

Alasan aplikasi harus memblokir pematian sistem. String ini akan dipotok untuk tujuan tampilan setelah MAX_STR_BLOCKREASON karakter.

Nilai kembali

Jika panggilan berhasil, nilai yang dikembalikan bukan nol.

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

Keterangan

Fungsi ini hanya dapat dipanggil dari utas yang membuat jendela yang ditentukan oleh parameter hWnd . Jika tidak, fungsi gagal dan kode kesalahan terakhir adalah ERROR_ACCESS_DENIED.

Aplikasi harus memanggil fungsi ini saat memulai operasi yang tidak dapat diinterupsi, seperti membakar CD atau DVD. Ketika operasi telah selesai, panggil fungsi ShutdownBlockReasonDestroy untuk menunjukkan bahwa sistem dapat dimatikan.

Karena pengguna biasanya terburu-buru saat mematikan sistem, mereka mungkin hanya menghabiskan beberapa detik melihat alasan pematian yang ditampilkan oleh sistem. Oleh karena itu, penting bahwa string alasan Anda pendek dan jelas. Misalnya "Pembakaran CD sedang berlangsung." lebih baik daripada "Aplikasi ini memblokir pematian sistem karena pembakaran CD sedang berlangsung. Jangan dimatikan."

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	winuser.h (sertakan Windows.h)
Pustaka	User32.lib
DLL	User32.dll
Set API	ext-ms-win-ntuser-misc-l1-1-0 (diperkenalkan dalam Windows 8)

Lihat juga

ShutdownBlockReasonDestroy

Mematikan