Compartilhar via

Função NotifyBootConfigStatus (winsvc.h)

  • Artigo

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

Confira também

Iniciando serviços automaticamente

Funções de serviço