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

Vedi anche

Avvio automatico dei servizi

Funzioni del servizio