Fungsi SetSuspendState (powrprof.h)

  • Artikel

Menangguhkan sistem dengan mematikan daya. Tergantung pada parameter Hibernasi , sistem memasuki status suspensi (tidur) atau hibernasi (S4).

Sintaks

BOOLEAN SetSuspendState(
  [in] BOOLEAN bHibernate,
  [in] BOOLEAN bForce,
  [in] BOOLEAN bWakeupEventsDisabled
);

Parameter

[in] bHibernate

Jika parameter ini TRUE, sistem akan berhibernasi. Jika parameternya FALSE, sistem akan ditangguhkan.

[in] bForce

Parameter ini tidak berpengaruh.

[in] bWakeupEventsDisabled

Jika parameter ini TRUE, sistem menonaktifkan semua peristiwa bangun. Jika parameternya FALSE, peristiwa bangun sistem apa pun tetap diaktifkan.

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

Proses panggilan harus memiliki hak istimewa SE_SHUTDOWN_NAME . Untuk mengaktifkan hak istimewa SE_SHUTDOWN_NAME , gunakan fungsi AdjustTokenPrivileges . Untuk informasi selengkapnya, lihat Mengubah Hak Istimewa dalam Token.

Aplikasi dapat menggunakan SetSuspendState untuk mentransisikan sistem dari status kerja ke status siaga (tidur), atau secara opsional, hibernasi (S4). Fungsi ini mirip dengan fungsi SetSystemPowerState .

Untuk informasi selengkapnya tentang menggunakan PowrProf.h, lihat Power Schemes. Untuk informasi tentang peristiwa yang dapat membangunkan sistem, lihat Peristiwa Bangun Sistem.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header powrprof.h
Pustaka PowrProf.lib
DLL PowrProf.dll

Lihat juga

PBT_APMQUERYSUSPEND

PBT_APMSUSPEND

Fungsi Manajemen Daya