PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • Mode de fonctionnement
  • Limitation
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
ServiceContrôle (Fonction)
En anglais : ServiceControl
Envoie un message de contrôle à un service. Ce service peut être un service présent sur le poste local ou sur un poste distant.
Versions 15 et supérieures
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
WEBDEV - Code ServeurLinux Cette fonction est désormais disponible pour les sites WEBDEV sous Linux.
Nouveauté 15
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
WEBDEV - Code ServeurLinux Cette fonction est désormais disponible pour les sites WEBDEV sous Linux.
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
WEBDEV - Code ServeurLinux Cette fonction est désormais disponible pour les sites WEBDEV sous Linux.
Exemple
// Met en pause le service présent dans la table TABLE_Service
SI ServiceContrôle(COL_Nom[TABLE_Service], serviceCmdPause) = Faux ALORS
        Erreur(ErreurInfo(errMessage))
FIN
Syntaxe
<Résultat> = ServiceContrôle(<Nom du service> , <Commande à envoyer> [, <Poste distant>])
<Résultat> : Booléen
  • Vrai si la commande a été envoyée au gestionnaire de services,
  • Faux dans le cas contraire. Pour plus de détails sur l'erreur, utilisez la fonction ErreurInfo.
<Nom du service> : Chaîne de caractères
Nom du service à contrôler.
<Commande à envoyer> : Constante de type Entier ou entier
Commande à envoyer au service :
serviceCmdArrêteArrête le service (équivalent à la fonction ServiceArrête).
serviceCmdPauseMet le service en pause (équivalent à la fonction ServicePause).
serviceCmdRelanceSort un service de la pause (équivalent à la fonction ServiceRelance).
serviceCmdRelireConfigDemande au service de relire ses paramètres de configuration (équivalent à la fonction ServiceActualise).

Il est également possible d'utiliser un entier compris entre 128 et 255. Cette plage de valeurs est réservée pour les commandes définies par le service lui-même (Consultez la documentation du service pour savoir quelles sont les commandes acceptées et leur action).
<Poste distant> : Chaîne de caractères optionnelle
Adresse IP du poste distant au format xxx.xxx.xxx.xxx (obtenu par la fonction NetAdresseIP) ou nom du poste distant (obtenu par la fonction NetNomMachine). Ce paramètre permet de contrôler un service sur un autre poste. Pour utiliser cette option, l'utilisateur doit être administrateur de la machine distante.
Si ce paramètre n'est pas précisé ou correspond à une chaîne vide, le service est manipulé en local.
Remarques

Mode de fonctionnement

La fonction ServiceContrôle envoie au gestionnaire de services une commande. Cette opération peut ne pas être effectuée immédiatement. Pour connaître l'état du service, utilisez la fonction ServiceAttendEtat.

Limitation

Les fonctions de gestion des services ne fonctionnent pas sous les systèmes suivants : Windows 98 ou Me.
Composante : wd270std.dll
Version minimum requise
  • Version 12
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire