SERVICE_FAILURE_ACTIONSA-Struktur (winsvc.h)
Stellt die Aktion dar, die der Dienstcontroller bei jedem Fehler eines Diensts ausführen soll. Ein Dienst gilt als fehlerhaft, wenn er beendet wird, ohne dem Dienstcontroller eine status von SERVICE_STOPPED zu melden.
Informationen zum Konfigurieren zusätzlicher Umstände, unter denen die Fehleraktionen ausgeführt werden sollen, finden Sie unter SERVICE_FAILURE_ACTIONS_FLAG.
Syntax
typedef struct _SERVICE_FAILURE_ACTIONSA {
DWORD dwResetPeriod;
LPSTR lpRebootMsg;
LPSTR lpCommand;
DWORD cActions;
SC_ACTION *lpsaActions;
} SERVICE_FAILURE_ACTIONSA, *LPSERVICE_FAILURE_ACTIONSA;
Member
dwResetPeriod
Die Zeit, nach der die Fehleranzahl in Sekunden auf null zurückgesetzt werden soll, wenn keine Fehler auftreten. Geben Sie INFINITE an, um anzugeben, dass dieser Wert nie zurückgesetzt werden soll.
lpRebootMsg
Die Nachricht, die vor dem Neustart als Reaktion auf die SC_ACTION_REBOOT-Servicecontrolleraktion an Serverbenutzer gesendet werden soll.
Wenn dieser Wert NULL ist, bleibt die Neustartmeldung unverändert. Wenn der Wert eine leere Zeichenfolge ("") ist, wird die Neustartmeldung gelöscht, und es wird keine Nachricht übertragen.
Dieses Element kann eine lokalisierte Zeichenfolge im folgenden Format angeben:
@[Path]dllname,-strID
Die Zeichenfolge mit dem Bezeichner strID wird aus dllname geladen. der Pfad ist optional. Weitere Informationen finden Sie unter RegLoadMUIString.
Windows Server 2003 und Windows XP: Lokalisierte Zeichenfolgen werden erst unter Windows Vista unterstützt.
lpCommand
Die Befehlszeile des Prozesses für die CreateProcess-Funktion, die als Reaktion auf die SC_ACTION_RUN_COMMAND-Dienstcontrolleraktion ausgeführt werden soll. Dieser Prozess wird unter demselben Konto wie der Dienst ausgeführt.
Wenn dieser Wert NULL ist, bleibt der Befehl unverändert. Wenn der Wert eine leere Zeichenfolge ("") ist, wird der Befehl gelöscht, und es wird kein Programm ausgeführt, wenn der Dienst fehlschlägt.
cActions
Die Anzahl der Elemente im lpsaActions-Array .
Wenn dieser Wert 0 ist, lpsaActions jedoch nicht NULL ist, werden der Zurücksetzungszeitraum und das Array von Fehleraktionen gelöscht.
lpsaActions
Ein Zeiger auf ein Array von SC_ACTION Strukturen.
Wenn dieser Wert NULL ist, werden die Elemente cActions und dwResetPeriod ignoriert.
Hinweise
Der Dienststeuerungs-Manager zählt, wie oft seit dem Systemstart ein Fehler bei jedem Dienst aufgetreten ist. Die Anzahl wird auf 0 zurückgesetzt, wenn der Dienst für dwResetPeriod-Sekunden keinen Fehler aufweist. Wenn der Dienst zum N-teMal ausfällt, führt der Dienstcontroller die aktion aus, die im Element [N-1] des lpsaActions-Arrays angegeben ist. Wenn N größer als cActions ist, wiederholt der Dienstcontroller die letzte Aktion im Array.
Hinweis
Der winsvc.h-Header definiert SERVICE_FAILURE_ACTIONS als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
Kopfzeile | winsvc.h (windows.h einschließen) |
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für