Funzione NotifyBootConfigStatus (winsvc.h)
Segnala lo stato di avvio al gestore del controllo del servizio. Viene usato dai programmi di verifica di avvio. Questa funzione può essere chiamata solo da un processo in esecuzione nell'account LocalSystem o Administrator.
Sintassi
BOOL NotifyBootConfigStatus(
[in] BOOL BootAcceptable
);
Parametri
[in] BootAcceptable
Se il valore è TRUE, il sistema salva la configurazione come ultima configurazione valida. Se il valore è FALSE, il sistema viene immediatamente riavviato usando la configurazione valida precedentemente salvata.
Valore restituito
Se il parametro BootAcceptable è FALSE, la funzione non restituisce.
Se l'ultima configurazione valida nota è stata salvata correttamente, il valore restituito è diverso da zero.
Se si verifica un errore, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.
I codici di errore seguenti possono essere impostati dal gestore di controllo del servizio. Altri codici di errore possono essere impostati dalle funzioni del Registro di sistema chiamate dalla gestione controllo del servizio per impostare i parametri nel Registro di sistema di configurazione.
| Codice restituito | Descrizione |
|---|---|
|
L'utente non dispone dell'autorizzazione per eseguire questa operazione. Solo il sistema e i membri del gruppo dell'amministratore possono farlo. |
Commenti
Salvare la configurazione di un sistema in esecuzione con questa funzione è un metodo accettabile per salvare l'ultima configurazione valida nota. Se la configurazione di avvio non è accettabile, usare questa funzione per riavviare il sistema usando la configurazione valida esistente.
Questa chiamata di funzione richiede che il token del chiamante disponga dell'autorizzazione per acquisire il diritto di accesso SC_MANAGER_MODIFY_BOOT_CONFIG. Per altre informazioni, vedere Sicurezza del servizio e diritti di accesso.
Requisiti
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | winsvc.h (include Windows.h) |
| Libreria | Advapi32.lib |
| DLL | Advapi32.dll |