NotifyBootConfigStatus-Funktion (winsvc.h)

  • Artikel

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
ERROR_ACCESS_DENIED
 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

Weitere Informationen

Dienste automatisch starten

Dienstfunktionen