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.

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

Confira também

Iniciando serviços automaticamente

Funções de serviço