NotifyBootConfigStatus-Funktion (winsvc.h)
Meldet die Start-status an den Dienststeuerungs-Manager. Es wird von Startüberprüfungsprogrammen verwendet. Diese Funktion kann nur von einem Prozess aufgerufen werden, der im LocalSystem- oder Administratorkonto ausgeführt wird.
Syntax
BOOL NotifyBootConfigStatus(
[in] BOOL BootAcceptable
);
Parameter
[in] BootAcceptable
Wenn der Wert TRUE ist, speichert das System die Konfiguration als letzte bekannte gute Konfiguration. Wenn der Wert FALSE ist, wird das System sofort neu gestartet, wobei die zuvor gespeicherte zuletzt bekannte gute Konfiguration verwendet wird.
Rückgabewert
Wenn der BootAcceptable-Parameter FALSE ist, wird die Funktion nicht zurückgegeben.
Wenn die zuletzt bekannte gute Konfiguration erfolgreich gespeichert wurde, ist der Rückgabewert nichtzero.
Wenn ein Fehler auftritt, ist der Rückgabewert 0. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Die folgenden Fehlercodes können vom Dienststeuerungs-Manager festgelegt werden. Andere Fehlercodes können von den Registrierungsfunktionen festgelegt werden, die vom Dienststeuerungs-Manager aufgerufen werden, um Parameter in der Konfigurationsregistrierung festzulegen.
| Rückgabecode | Beschreibung |
|---|---|
|
Der Benutzer verfügt nicht über die Berechtigung zum Durchführen dieses Vorgangs. Nur das System und die Mitglieder der Gruppe des Administrators können dies tun. |
Hinweise
Das Speichern der Konfiguration eines ausgeführten Systems mit dieser Funktion ist eine akzeptable Methode zum Speichern der letzten bekannten guten Konfiguration. Wenn die Startkonfiguration inakzeptabel ist, verwenden Sie diese Funktion, um das System mit der vorhandenen zuletzt bekannten guten Konfiguration neu zu starten.
Für diesen Funktionsaufruf muss das Token des Aufrufers über die Berechtigung zum Abrufen des SC_MANAGER_MODIFY_BOOT_CONFIG-Zugriffsberechtigung verfügen. Weitere Informationen finden Sie unter Dienstsicherheit und Zugriffsrechte.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winsvc.h (einschließen von Windows.h) |
| Bibliothek | Advapi32.lib |
| DLL | Advapi32.dll |