Fonction QueryServiceConfigA (winsvc.h)

Article
08/27/2023

Récupère les paramètres de configuration du service spécifié. Les paramètres de configuration facultatifs sont disponibles à l’aide de la fonction QueryServiceConfig2 .

Syntaxe

BOOL QueryServiceConfigA(
  [in]            SC_HANDLE               hService,
  [out, optional] LPQUERY_SERVICE_CONFIGA lpServiceConfig,
  [in]            DWORD                   cbBufSize,
  [out]           LPDWORD                 pcbBytesNeeded
);

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_CONFIG. Pour plus d’informations, consultez Sécurité des services et droits d’accès.

[out, optional] lpServiceConfig

Pointeur vers une mémoire tampon qui reçoit les informations de configuration du service. Le format des données est une structure QUERY_SERVICE_CONFIG .

La taille maximale de ce tableau est de 8 000 octets. Pour déterminer la taille requise, spécifiez NULL pour ce paramètre et 0 pour le paramètre cbBufSize . La fonction échoue et GetLastError retourne ERROR_INSUFFICIENT_BUFFER. Le paramètre pcbBytesNeeded reçoit la taille requise.

[in] cbBufSize

Taille de la mémoire tampon pointée vers le paramètre lpServiceConfig , en octets.

[out] pcbBytesNeeded

Pointeur vers une variable qui reçoit le nombre d’octets nécessaires pour stocker toutes les informations de configuration, si la fonction échoue avec ERROR_INSUFFICIENT_BUFFER.

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 peuvent être définies 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_CONFIG.
ERROR_INSUFFICIENT_BUFFER	Il existe plus d’informations de configuration de service que ne le feraient dans la mémoire tampon lpServiceConfig . Le nombre d’octets requis pour obtenir toutes les informations est retourné dans le paramètre pcbBytesNeeded. Rien n’est écrit dans lpServiceConfig.
ERROR_INVALID_HANDLE	Le handle spécifié n’est pas valide.

Remarques

La fonction QueryServiceConfig retourne les informations de configuration du service conservées dans le Registre pour un service particulier. Ces informations de configuration sont d’abord définies par un programme de contrôle de service à l’aide de la fonction CreateService . Ces informations peuvent avoir été mises à jour par un programme de configuration de service à l’aide de la fonction ChangeServiceConfig .

Si le service était en cours d’exécution lors de la dernière modification des informations de configuration, les informations retournées par QueryServiceConfig ne reflètent pas la configuration actuelle du service. Au lieu de cela, il reflète la configuration du service lors de sa prochaine exécution. La clé DisplayName est une exception à cela. Lorsque la clé DisplayName est modifiée, elle prend effet immédiatement, que le service soit en cours d’exécution ou non.

Exemples

Pour obtenir un exemple, consultez Interrogation de la configuration d’un service.

Notes

L’en-tête winsvc.h définit QueryServiceConfig comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise	Valeur
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