Bagikan melalui


Fungsi DeleteService (winsvc.h)

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

Lihat juga

CloseServiceHandle

ControlService

CreateService

OpenService

Fungsi Layanan

Penginstalan, Penghapusan, dan Enumerasi Layanan