DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions Service
  • Présentation
  • Variable Service
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Présentation
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).
Variable Service
La variable Service est composée des éléments suivants :
ElémentTypeEffet
Service.DémarrageConstante de type entierMode 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éenIndique que le service ne sera pas lancé immédiatement au démarrage du système mais légèrement plus tard.
Windows Remarques :
  • Cet élément n'est pris en compte que pour les services Windows.
  • Cet élément n'est pris en compte qu'à partir de Windows Vista.
Service.DescriptionChaîne de caractèresDescription du service.
Windows Remarque : Cette information apparaît dans la rubrique "Nom complet" du gestionnaire de services.
Service.DescriptionLongueChaîne de caractèresDescription détaillée du service.
Windows Remarque : cette information apparaît dans la rubrique "Description" du gestionnaire de services.
Service.ErreurDémarrageConstante de type entierTraitement 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.LigneCommandeChaîne de caractèresLigne de commande complète du service (chemin de l'exécutable et paramètres).
Service.TypeConstante de type entierType 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.UtilisateurChaîne de caractères ou Constante de type chaîneCompte 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.MotDePasseChaîne de caractèresMot 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.
Windows A partir de Windows 2000, des éléments supplémentaires sont disponibles pour permettre de gérer les défaillances du service. Une défaillance du service est un arrêt de l'exécutable suite à une erreur fatale. Sous Windows NT et Linux, ces éléments sont ignorés.
ElémentTypeEffet
Service.NbActionSurDéfaillanceEntierNombre 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éfaillanceTableau de constantes de type EntierAction 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éfaillanceTableau d'entiersDélai (en millisecondes) avant le déclenchement de l'action spécifiée dans Service.ActionSurDéfaillance.
Service.LanceAppliSurDéfaillanceChaîne de caractèresLigne 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éfaillanceChaîne de caractèresMessage envoyé aux utilisateurs connecté à l'ordinateur par le réseau en cas de reboot du système.
Service.ReinitCompteurDéfaillanceEntierDurée (en secondes) au bout de laquelle le compteur de défaillances est remis à 0 si aucune défaillance ne s'est produite.
Version minimum requise
  • Version 11
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale