NotifyBootConfigStatus, fonction (winsvc.h)

Signale le status de démarrage au gestionnaire de contrôle de service. Il est utilisé par les programmes de vérification de démarrage. Cette fonction peut être appelée uniquement par un processus en cours d’exécution dans le compte LocalSystem ou Administrator.

Syntaxe

BOOL NotifyBootConfigStatus(
  [in] BOOL BootAcceptable
);

Paramètres

[in] BootAcceptable

Si la valeur est TRUE, le système enregistre la configuration en tant que dernière bonne configuration connue. Si la valeur est FALSE, le système redémarre immédiatement, en utilisant la dernière bonne configuration connue précédemment enregistrée.

Valeur retournée

Si le paramètre BootAcceptable a la valeur FALSE, la fonction ne retourne pas.

Si la dernière bonne configuration connue a été enregistrée avec succès, la valeur de retour est différente de zéro.

Si une erreur se produit, la valeur de retour est zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Les codes d’erreur suivants peuvent être définis par le gestionnaire de contrôle de service. D’autres codes d’erreur peuvent être définis par les fonctions de Registre appelées par le gestionnaire de contrôle de service pour définir des paramètres dans le registre de configuration.

Code de retour	Description
ERROR_ACCESS_DENIED	L'utilisateur n'est pas autorisé à effectuer cette opération. Seuls le système et les membres du groupe administrateur peuvent le faire.

Remarques

L’enregistrement de la configuration d’un système en cours d’exécution avec cette fonction est une méthode acceptable pour enregistrer la dernière bonne configuration connue. Si la configuration de démarrage est inacceptable, utilisez cette fonction pour redémarrer le système à l’aide de la dernière bonne configuration connue existante.

Cet appel de fonction nécessite que le jeton de l’appelant dispose de l’autorisation d’acquérir le droit d’accès SC_MANAGER_MODIFY_BOOT_CONFIG. Pour plus d’informations, consultez Sécurité du service et droits d’accès.

Configuration requise

Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winsvc.h (inclure Windows.h)
Bibliothèque	Advapi32.lib
DLL	Advapi32.dll

Voir aussi

Démarrage automatique des services

Fonctions de service