Fungsi CloseServiceHandle (winsvc.h)

Artikel
03/13/2024

Menutup handel ke manajer kontrol layanan atau objek layanan.

Sintaks

BOOL CloseServiceHandle(
  [in] SC_HANDLE hSCObject
);

Parameter

[in] hSCObject

Handel ke objek manajer kontrol layanan atau objek layanan untuk ditutup. Menangani objek manajer kontrol layanan dikembalikan oleh fungsi OpenSCManager , dan handel ke objek layanan dikembalikan oleh fungsi OpenService atau CreateService .

Mengembalikan nilai

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. Kode kesalahan lainnya dapat diatur oleh fungsi registri yang dipanggil oleh manajer kontrol layanan.

Menampilkan kode	Deskripsi
ERROR_INVALID_HANDLE	Handel yang ditentukan tidak valid.

Keterangan

Fungsi CloseServiceHandle tidak menghancurkan objek manajer kontrol layanan yang dimaksud oleh handel. Objek manajer kontrol layanan tidak dapat dihancurkan. Objek layanan dapat dihancurkan dengan memanggil fungsi DeleteService .

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