Fungsi RestartDialogEx (shlobj_core.h)

Artikel
08/26/2023

[Fungsi ini tersedia melalui Windows XP Service Pack 2 (SP2) dan Windows Server 2003. Ini mungkin diubah atau tidak tersedia dalam versi Windows berikutnya.]

Menampilkan kotak dialog yang meminta pengguna untuk memulai ulang Windows. Ketika pengguna mengklik tombol , fungsi memanggil ExitWindowsEx untuk mencoba memulai ulang Windows.

Sintaks

int RestartDialogEx(
  [in, optional] HWND   hwnd,
  [in, optional] PCWSTR pszPrompt,
                 DWORD  dwReturn,
                 DWORD  dwReasonCode
);

Parameter

[in, optional] hwnd

Jenis: HWND

Handel ke jendela induk.

[in, optional] pszPrompt

Jenis: PCWSTR

String null-terminated yang berisi teks yang ditampilkan dalam kotak dialog untuk meminta pengguna.

dwReturn

Jenis: DWORD

Bendera yang menentukan jenis matikan.

Parameter ini harus menyertakan salah satu nilai berikut.

EWX_LOGOFF

Mematikan semua proses yang berjalan dalam konteks keamanan proses yang memanggil fungsi ini. Kemudian mencatat pengguna nonaktif.

EWX_POWEROFF

Mematikan sistem dan mematikan daya. Sistem harus mendukung fitur matikan. Proses panggilan harus memiliki hak istimewa SE_SHUTDOWN_NAME . Untuk informasi selengkapnya, lihat ExitWindowsEx.

EWX_REBOOT

Mematikan sistem lalu menghidupkan ulang sistem. Proses panggilan harus memiliki hak istimewa SE_SHUTDOWN_NAME. Untuk informasi selengkapnya, lihat ExitWindowsEx.

EWX_SHUTDOWN

Mematikan sistem ke titik di mana aman untuk mematikan daya. Pada titik ini, semua buffer file telah dibersihkan ke disk, dan semua proses yang berjalan telah berhenti. Jika sistem mendukung fitur matikan, daya juga dimatikan. Proses panggilan harus memiliki hak istimewa SE_SHUTDOWN_NAME. Untuk informasi selengkapnya, lihat ExitWindowsEx.

Parameter ini dapat secara opsional menyertakan nilai berikut.

EWX_FORCE

Memaksa proses untuk mengakhiri. Ketika bendera ini diatur, sistem tidak mengirim pesan WM_QUERYENDSESSION dan WM_ENDSESSION . Hal ini dapat menyebabkan aplikasi kehilangan data. Oleh karena itu, Anda hanya boleh menggunakan bendera ini dalam keadaan darurat.

EWX_FORCEIFHUNG

Memaksa proses untuk mengakhiri jika mereka tidak merespons pesan WM_QUERYENDSESSION atau WM_ENDSESSION . Bendera ini diabaikan jika EWX_FORCE digunakan.

dwReasonCode

Jenis: DWORD

Windows XP:Menentukan alasan untuk memulai pematian. Untuk informasi selengkapnya, lihat Kode Alasan Pematian Sistem.

Windows 2000: Parameter ini diabaikan.

Menampilkan nilai

Jenis: int

Mengembalikan pengidentifikasi tombol yang ditekan untuk menutup kotak dialog.

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	shlobj_core.h (termasuk Shlobj.h)
Pustaka	Shell32.lib
DLL	Shell32.dll (versi 5.0 atau yang lebih baru)

Bagikan melalui