Fonction QueryServiceStatus (winsvc.h)

Article
08/27/2023

Récupère la status actuelle du service spécifié.

Cette fonction a été remplacée par la fonction QueryServiceStatusEx . QueryServiceStatusEx retourne les mêmes informations que celles renvoyées par QueryServiceStatus , avec l’ajout de l’identificateur de processus et d’informations supplémentaires pour le service.

Syntaxe

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

Paramètres

[in] hService

Handle du service. Ce handle est retourné par la fonction OpenService ou CreateService et doit disposer du droit d’accès SERVICE_QUERY_STATUS. Pour plus d’informations, consultez Sécurité des services et droits d’accès.

[out] lpServiceStatus

Pointeur vers une structure de SERVICE_STATUS qui reçoit les informations status.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Les codes d’erreur suivants peuvent être définis par le gestionnaire de contrôle de service. D’autres codes d’erreur peuvent être définis par les fonctions de Registre appelées par le gestionnaire de contrôle de service.

Code de retour	Description
ERROR_ACCESS_DENIED	Le handle n’a pas le droit d’accès SERVICE_QUERY_STATUS.
ERROR_INVALID_HANDLE	Le handle n'est pas valide.

Remarques

La fonction QueryServiceStatus retourne les informations de status de service les plus récentes signalées au gestionnaire de contrôle de service. Si le service vient de modifier son status, il n’a peut-être pas encore mis à jour le gestionnaire de contrôle de service.

Configuration requise


Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winsvc.h (inclure Windows.h)
Bibliothèque	Advapi32.lib
DLL	Advapi32.dll