Fungsi NotifyBootConfigStatus (winsvc.h)

Melaporkan status boot ke manajer kontrol layanan. Ini digunakan oleh program verifikasi boot. Fungsi ini hanya dapat dipanggil oleh proses yang berjalan di akun LocalSystem atau Administrator.

Sintaks

BOOL NotifyBootConfigStatus(
  [in] BOOL BootAcceptable
);

Parameter

[in] BootAcceptable

Jika nilainya TRUE, sistem menyimpan konfigurasi sebagai konfigurasi baik terakhir yang diketahui. Jika nilainya FALSE, sistem segera melakukan boot ulang, menggunakan konfigurasi baik terakhir yang diketahui sebelumnya.

Menampilkan nilai

Jika parameter BootAcceptable false, fungsi tidak akan kembali.

Jika konfigurasi baik yang terakhir diketahui berhasil disimpan, nilai yang dikembalikan bukan nol.

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

Kode kesalahan berikut dapat diatur oleh manajer kontrol layanan. Kode kesalahan lainnya dapat diatur oleh fungsi registri yang dipanggil oleh manajer kontrol layanan untuk mengatur parameter dalam registri konfigurasi.

Menampilkan kode	Deskripsi
ERROR_ACCESS_DENIED	Pengguna tidak memiliki izin untuk melakukan operasi ini. Hanya sistem dan anggota grup Administrator yang dapat melakukannya.

Keterangan

Menyimpan konfigurasi sistem yang sedang berjalan dengan fungsi ini adalah metode yang dapat diterima untuk menyimpan konfigurasi baik yang terakhir diketahui. Jika konfigurasi boot tidak dapat diterima, gunakan fungsi ini untuk me-reboot sistem menggunakan konfigurasi baik terakhir yang diketahui.

Panggilan fungsi ini mengharuskan token penelepon memiliki izin untuk memperoleh hak akses SC_MANAGER_MODIFY_BOOT_CONFIG. Untuk informasi selengkapnya, lihat Keamanan Layanan dan Hak Akses.

Persyaratan

Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	winsvc.h (sertakan Windows.h)
Pustaka	Advapi32.lib
DLL	Advapi32.dll

Lihat juga

Memulai Layanan Secara Otomatis

Fungsi Layanan