|
|
|
|
|
|
|
|
|
|
- Présentation
- Variable Service
La variable Service permet : - de configurer les paramètres de l'installation du service (utilisés par la fonction ServiceInstalle).
- de récupérer les paramètres d'un service (fonction ServiceInfo).
- de modifier les paramètres d'un service (fonction ServiceModifie).
La variable Service est composée des éléments suivants : | | | | Elément | Type | Effet |
|---|
| Service.Démarrage | Constante de type entier | Mode de démarrage du service :- serviceDémarrageAutomatique : Démarrage automatique après l'initialisation du système.
- serviceDémarrageDésactivé : Le service est désactivé. Toute tentative de démarrage provoque une erreur.
- serviceDémarrageManuel : Démarrage manuel (par exemple avec la fonction ServiceDémarre).
- serviceDémarrageSystème : Démarrage automatique en même temps que le système d'exploitation (utilisé par les pilotes).
| | Service.DémarrageRetardé | Booléen | Indique que le service ne sera pas lancé immédiatement au démarrage du système mais légèrement plus tard. | | Service.Description | Chaîne de caractères | Description du service. | | Service.DescriptionLongue | Chaîne de caractères | Description détaillée du service. | | Service.ErreurDémarrage | Constante de type entier | Traitement par Windows des erreurs lors du démarrage d'un service (cas des services avec démarrage automatique) :- serviceErreurCritique : Le système inscrit l'échec de démarrage du service dans le journal de l'observateur d'événements et redémarre en mode "Dernière bonne configuration connue".
- serviceErreurGrave : Le système inscrit l'échec de démarrage du service dans le journal de l'observateur d'événements et redémarre en mode "Dernière bonne configuration connue" s'il n'est pas déjà dans ce mode là .
- serviceErreurIgnore : Le système ne fait rien de spécial si le service ne démarre pas.
- serviceErreurLog : Le système inscrit l'échec de démarrage du service dans le journal de l'observateur d'événements.
| | Service.LigneCommande | Chaîne de caractères | Ligne de commande complète du service (chemin de l'exécutable et paramètres). | | Service.Type | Constante de type entier | Type du service :- serviceTypeInteractifPartagé : Service autorisé à interagir avec le bureau et partageant son processus avec d'autres services.
- serviceTypeInteractifSimple : Service autorisé à interagir avec le bureau et fonctionnant seul dans son processus.
- serviceTypePartagé : Service standard partageant son processus avec d'autres services.
- serviceTypePiloteNoyau : Pilote du noyau.
- serviceTypePiloteSystèmeFichier : Pilote de système de fichier.
- serviceTypeSimple : Service standard fonctionnant seul dans son processus.
| | Service.Utilisateur | Chaîne de caractères ou Constante de type chaîne | Compte utilisateur qui exécutera le service ou l'une des constantes suivantes :- CompteServiceLocal : Compte local qui a des droits recommandés pour exécuter un service. Sur le réseau, ce compte sera considéré comme invité. Cette constante est disponible uniquement en modification (fonction ServiceModifie).
- CompteServiceRéseau : Compte local qui a des droits recommandés pour exécuter un service. Sur le réseau, ce compte aura les droits de l'ordinateur en cours.
- CompteSystèmeLocal : Compte local représentant le système d'exploitation. Ce compte a tout les droits. Sur le réseau, ce compte aura les droits de l'ordinateur en cours.
Cette constante correspond au compte "LocalSystem".
Remarque : Les comptes identifiés par les constantes CompteServiceLocal,CompteServiceRéseau et CompteSystèmeLocal n'ont pas de mot de passe. | | Service.MotDePasse | Chaîne de caractères | Mot de passe du compte utilisateur |
Remarque : Si un service est d'un type autorisé à agir avec le bureau (serviceTypeInteractifPartagé ou serviceTypeInteractifSimple), son compte utilisateur doit être CompteSystèmeLocal. Les autres valeurs seront ignorées. Les services autorisés à interagir avec le bureau ne sont plus disponibles à partir de Windows Vista. | | | | Elément | Type | Effet |
|---|
| Service.NbActionSurDéfaillance | Entier | Nombre d'éléments dans les tableaux Service.ActionSurDéfaillance et Service.DélaiAvantActionSurDéfaillance.- A la première défaillance du service, l'action spécifiée dans Service.ActionSurDéfaillance[1] est exécutée.
- A la Nième défaillance du service, l'action spécifiée dans Service.ActionSurDéfaillance[n] est exécutée. Si le tableau contient moins de n éléments, la dernière action décrite est répétée pour toutes les défaillances suivantes.
| | Service.ActionSurDéfaillance | Tableau de constantes de type Entier | Action exécutée en cas de défaillance du service :- serviceEchecIgnore : la défaillance du service est ignorée, le service s'arrête.
- serviceEchecLanceAppli : le gestionnaire de service lance la commande décrite dans Service.LanceAppliSurDéfaillance.
- serviceEchecReboot : le gestionnaire de service redémarre l'ordinateur.
- serviceEchecRedémarreService : le gestionnaire de service redémarre le service.
| | Service.DélaiAvantActionSurDéfaillance | Tableau d'entiers | Délai (en millisecondes) avant le déclenchement de l'action spécifiée dans Service.ActionSurDéfaillance. | | Service.LanceAppliSurDéfaillance | Chaîne de caractères | Ligne de commande appelée dans le traitement de l'action serviceEchecLanceAppli. Si cette ligne de commande contient la chaîne %1, celle-ci sera remplacée par le nombre de défaillances successives du service au moment de l'appel. | | Service.MessageRebootSurDéfaillance | Chaîne de caractères | Message envoyé aux utilisateurs connecté à l'ordinateur par le réseau en cas de reboot du système. | | Service.ReinitCompteurDéfaillance | Entier | Durée (en secondes) au bout de laquelle le compteur de défaillances est remis à 0 si aucune défaillance ne s'est produite. |
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|