Função NotifyBootConfigStatus (winsvc.h)
Relata o status de inicialização para o gerenciador de controle de serviço. Ele é usado por programas de verificação de inicialização. Essa função só pode ser chamada por um processo em execução na conta do LocalSystem ou do Administrador.
Sintaxe
BOOL NotifyBootConfigStatus(
[in] BOOL BootAcceptable
);
Parâmetros
[in] BootAcceptable
Se o valor for TRUE, o sistema salvará a configuração como a última boa configuração conhecida. Se o valor for FALSE, o sistema será reinicializado imediatamente, usando a última configuração conhecida anteriormente.
Valor retornado
Se o parâmetro BootAcceptable for FALSE, a função não retornará.
Se a última boa configuração conhecida tiver sido salva com êxito, o valor retornado será diferente de zero.
Se ocorrer um erro, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Os códigos de erro a seguir podem ser definidos pelo gerenciador de controle de serviço. Outros códigos de erro podem ser definidos pelas funções do Registro que são chamadas pelo gerenciador de controle de serviço para definir parâmetros no registro de configuração.
| Código de retorno | Descrição |
|---|---|
|
O usuário não tem permissão para executar esta operação. Somente o sistema e os membros do grupo do Administrador podem fazer isso. |
Comentários
Salvar a configuração de um sistema em execução com essa função é um método aceitável para salvar a última configuração boa conhecida. Se a configuração de inicialização for inaceitável, use essa função para reinicializar o sistema usando a última configuração boa conhecida existente.
Essa chamada de função exige que o token do chamador tenha permissão para adquirir o direito de acesso SC_MANAGER_MODIFY_BOOT_CONFIG. Para obter mais informações, consulte Segurança do serviço e Direitos de Acesso.
Requisitos
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | winsvc.h (inclua Windows.h) |
| Biblioteca | Advapi32.lib |
| DLL | Advapi32.dll |