Fungsi QueryServiceStatus (winsvc.h)

Artikel
08/27/2023

Mengambil status layanan yang ditentukan saat ini.

Fungsi ini telah digantikan oleh fungsi QueryServiceStatusEx . QueryServiceStatusEx mengembalikan informasi yang sama yang dikembalikan QueryServiceStatus , dengan penambahan pengidentifikasi proses dan informasi tambahan untuk layanan.

Sintaks

BOOL QueryServiceStatus(
  [in]  SC_HANDLE        hService,
  [out] LPSERVICE_STATUS lpServiceStatus
);

Parameter

[in] hService

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

[out] lpServiceStatus

Penunjuk ke struktur SERVICE_STATUS yang menerima informasi status.

Menampilkan 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_ACCESS_DENIED	Handel tidak memiliki hak akses SERVICE_QUERY_STATUS.
ERROR_INVALID_HANDLE	Handel tidak valid.

Keterangan

Fungsi QueryServiceStatus mengembalikan informasi status layanan terbaru yang dilaporkan ke manajer kontrol layanan. Jika layanan baru saja mengubah statusnya, layanan mungkin belum memperbarui manajer kontrol layanan.

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