Bagikan melalui


Fungsi QueryServiceStatus (winsvc.h)

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

Lihat juga

ControlService

CreateService

OpenService

QueryServiceStatusEx

SERVICE_STATUS

Fungsi Layanan

Startup Layanan

SetServiceStatus