structure SERVICE_DESCRIPTIONA (winsvc.h)
Contient une description de service.
Syntaxe
typedef struct _SERVICE_DESCRIPTIONA {
LPSTR lpDescription;
} SERVICE_DESCRIPTIONA, *LPSERVICE_DESCRIPTIONA;
Membres
lpDescription
Description du service. Si ce membre est 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 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 : chaînes localisées ne sont pas prises en charge tant que Windows Vista n’est pas pris en charge.
Remarques
Une description de null indique qu’aucune description de service n’existe. La description du service est NULL lorsque le service est créé.
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 du de configuration d’un service ou interrogation de la configuration d’un service.
Note
L’en-tête winsvc.h définit SERVICE_DESCRIPTION en tant qu’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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows XP [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| d’en-tête | winsvc.h (inclure Windows.h) |