Partager via

structure SERVICE_DESCRIPTIONA (winsvc.h)

  • Article

Contient une description de service.

Syntaxe

typedef struct _SERVICE_DESCRIPTIONA {
  LPSTR lpDescription;
} SERVICE_DESCRIPTIONA, *LPSERVICE_DESCRIPTIONA;

Membres

lpDescription

Description du service. Si ce membre a la valeur NULL, la description reste inchangée. Si cette valeur est une chaîne vide («  »), la description actuelle est supprimée.

La description du service ne doit pas dépasser la taille d’une valeur de Registre de type REG_SZ.

Ce membre peut spécifier une chaîne localisée au format suivant :

@[path]dllname,-strID

La chaîne avec l’identificateur strID est chargée à partir de dllname ; le chemin d’accès est facultatif. Pour plus d’informations, consultez RegLoadMUIString.

Windows Server 2003 et Windows XP : Les chaînes localisées ne sont pas prises en charge avant Windows Vista.

Remarques

Une description de NULL indique qu’il n’existe aucune description de service. La description du service est NULL lors de la création du service.

La description est simplement un commentaire qui explique l’objectif du service. Par exemple, pour le service DHCP, vous pouvez utiliser la description « Fournit des adresses Internet pour l’ordinateur sur votre réseau ».

Vous pouvez définir la description à l’aide de la fonction ChangeServiceConfig2 . Vous pouvez récupérer la description à l’aide de la fonction QueryServiceConfig2 . La description est également affichée par le composant logiciel enfichable Services.

Exemples

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

Notes

L’en-tête winsvc.h définit SERVICE_DESCRIPTION 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

   
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
En-tête winsvc.h (inclure Windows.h)

Voir aussi

ChangeServiceConfig2

QueryServiceConfig2