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
ERROR_ACCESS_DENIED
O identificador não tem o direito de acesso DELETE.
ERROR_INVALID_HANDLE
O identificador especificado é inválido.
ERROR_SERVICE_MARKED_FOR_DELETE
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

Confira também

CloseServiceHandle

ControlService

CreateService

Openservice

Funções de serviço

Instalação, remoção e enumeração de serviço