Partager via


Fonction QueryServiceStatus (winsvc.h)

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

Voir aussi

ControlService

CreateService

OpenService

QueryServiceStatusEx

SERVICE_STATUS

Fonctions de service

Démarrage du service

SetServiceStatus