structure SERVICE_FAILURE_ACTIONSA (winsvc.h)

Article
08/27/2023

Représente l’action que le contrôleur de service doit effectuer sur chaque défaillance d’un service. Un service est considéré comme ayant échoué lorsqu’il se termine sans signaler un status de SERVICE_STOPPED au contrôleur de service.

Pour configurer des circonstances supplémentaires dans lesquelles les actions d’échec doivent être exécutées, consultez SERVICE_FAILURE_ACTIONS_FLAG.

Syntaxe

typedef struct _SERVICE_FAILURE_ACTIONSA {
  DWORD     dwResetPeriod;
  LPSTR     lpRebootMsg;
  LPSTR     lpCommand;
  DWORD     cActions;
  SC_ACTION *lpsaActions;
} SERVICE_FAILURE_ACTIONSA, *LPSERVICE_FAILURE_ACTIONSA;

Membres

dwResetPeriod

Délai après lequel réinitialiser le nombre d’échecs à zéro s’il n’y a pas d’échecs, en secondes. Spécifiez INFINITE pour indiquer que cette valeur ne doit jamais être réinitialisée.

lpRebootMsg

Message à diffuser aux utilisateurs du serveur avant de redémarrer en réponse à l’action du contrôleur de service SC_ACTION_REBOOT .

Si cette valeur est NULL, le message de redémarrage est inchangé. Si la valeur est une chaîne vide (« »), le message de redémarrage est supprimé et aucun message n’est diffusé.

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.

lpCommand

Ligne de commande du processus pour que la fonction CreateProcess s’exécute en réponse à l’action du contrôleur de service SC_ACTION_RUN_COMMAND . Ce processus s’exécute sous le même compte que le service.

Si cette valeur est NULL, la commande est inchangée. Si la valeur est une chaîne vide (« »), la commande est supprimée et aucun programme n’est exécuté lorsque le service échoue.

cActions

Nombre d’éléments dans le tableau lpsaActions .

Si cette valeur est 0, mais que lpsaActions n’a pas la valeur NULL, la période de réinitialisation et le tableau des actions d’échec sont supprimés.

lpsaActions

Pointeur vers un tableau de structures SC_ACTION .

Si cette valeur est NULL, les membres cActions et dwResetPeriod sont ignorés.

Remarques

Le gestionnaire de contrôle de service compte le nombre de fois où chaque service a échoué depuis le démarrage du système. Le nombre est réinitialisé à 0 si le service n’a pas échoué pendant les secondes dwResetPeriod . Lorsque le service échoue pour la Nième fois, le contrôleur de service effectue l’action spécifiée dans l’élément [N-1] du tableau lpsaActions . Si N est supérieur à cActions, le contrôleur de service répète la dernière action du tableau.

Notes

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

Condition requise	Valeur
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

SERVICE_FAILURE_ACTIONS_FLAG

Partager via