Fungsi DeleteService (winsvc.h)

Artikel
03/09/2024

Menandai layanan yang ditentukan untuk penghapusan dari database manajer kontrol layanan.

Sintaks

BOOL DeleteService(
  [in] SC_HANDLE hService
);

Parameter

[in] hService

Handel ke layanan. Handel ini dikembalikan oleh fungsi OpenService atau CreateService , dan harus memiliki hak akses DELETE. Untuk informasi selengkapnya, lihat Keamanan Layanan dan Hak Akses.

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.

Kode kesalahan berikut dapat diatur oleh manajer kontrol layanan. Yang lain dapat diatur oleh fungsi registri yang dipanggil oleh manajer kontrol layanan.

Menampilkan kode	Deskripsi
ERROR_ACCESS_DENIED	Handel tidak memiliki hak akses DELETE.
ERROR_INVALID_HANDLE	Handel yang ditentukan tidak valid.
ERROR_SERVICE_MARKED_FOR_DELETE	Layanan yang ditentukan telah ditandai untuk dihapus.

Keterangan

Fungsi DeleteService menandai layanan untuk dihapus dari database manajer kontrol layanan. Entri database tidak dihapus sampai semua handel terbuka ke layanan telah ditutup oleh panggilan ke fungsi CloseServiceHandle , dan layanan tidak berjalan. Layanan yang sedang berjalan dihentikan oleh panggilan ke fungsi ControlService dengan kode kontrol SERVICE_CONTROL_STOP. Jika layanan tidak dapat dihentikan, entri database dihapus saat sistem dimulai ulang.

Manajer kontrol layanan menghapus layanan dengan menghapus kunci layanan dan subkuntangnya dari registri.

Contoh

Misalnya, lihat Menghapus Layanan.

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	winsvc.h (termasuk Windows.h)
Pustaka	Advapi32.lib
DLL	Advapi32.dll