Função DeleteService (winsvc.h)
Marca o serviço especificado para exclusão do banco de dados do gerenciador de controle de serviço.
Sintaxe
BOOL DeleteService(
[in] SC_HANDLE hService
);
Parâmetros
[in] hService
Um identificador para o serviço. Esse identificador é retornado pela função OpenService ou CreateService e deve ter o direito de acesso DELETE. Para obter mais informações, consulte Segurança do Serviço e Direitos de Acesso.
Valor retornado
Se a função for bem-sucedida, o valor retornado será diferente de zero.
Se a função falhar, 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. Outras podem ser definidas pelas funções do Registro que são chamadas pelo gerenciador de controle de serviço.
Código de retorno | Descrição |
---|---|
|
O identificador não tem o direito de acesso DELETE. |
|
O identificador especificado é inválido. |
|
O serviço especificado já foi marcado para exclusão. |
Comentários
A função DeleteService marca um serviço para exclusão do banco de dados do gerenciador de controle de serviço. A entrada do banco de dados não é removida até que todos os identificadores abertos para o serviço tenham sido fechados por chamadas para a função CloseServiceHandle e o serviço não esteja em execução. Um serviço em execução é interrompido por uma chamada para a função ControlService com o código de controle SERVICE_CONTROL_STOP. Se o serviço não puder ser interrompido, a entrada do banco de dados será removida quando o sistema for reiniciado.
O gerenciador de controle de serviço exclui o serviço excluindo a chave de serviço e suas subchaves do registro.
Exemplos
Para obter um exemplo, consulte Excluindo um serviço.
Requisitos
Requisito | Valor |
---|---|
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 (incluir Windows.h) |
Biblioteca | Advapi32.lib |
DLL | Advapi32.dll |