Función DeleteService (winsvc.h)

Artículo
03/13/2024

Marca el servicio especificado para su eliminación de la base de datos del Administrador de control de servicios.

Sintaxis

BOOL DeleteService(
  [in] SC_HANDLE hService
);

Parámetros

[in] hService

Identificador del servicio. La función OpenService o CreateService devuelve este identificador y debe tener el derecho de acceso DELETE. Para obtener más información, consulte Derechos de acceso y seguridad de servicio.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

El administrador de control de servicios puede establecer los siguientes códigos de error. Otras pueden establecerse mediante las funciones del Registro a las que llama el administrador de control de servicios.

Código devuelto	Descripción
ERROR_ACCESS_DENIED	El identificador no tiene el derecho de acceso DELETE.
ERROR_INVALID_HANDLE	El identificador especificado no es válido.
ERROR_SERVICE_MARKED_FOR_DELETE	El servicio especificado ya se ha marcado para su eliminación.

Comentarios

La función DeleteService marca un servicio para su eliminación de la base de datos del Administrador de control de servicios. La entrada de base de datos no se quita hasta que se hayan cerrado todos los identificadores abiertos del servicio mediante llamadas a la función CloseServiceHandle y el servicio no se está ejecutando. Una llamada a la función ControlService detiene un servicio en ejecución con el código de control SERVICE_CONTROL_STOP. Si no se puede detener el servicio, la entrada de la base de datos se quita cuando se reinicia el sistema.

El administrador de control de servicio elimina el servicio eliminando la clave de servicio y sus subclaves del Registro.

Ejemplos

Para obtener un ejemplo, consulte Eliminación de un servicio.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winsvc.h (incluye Windows.h)
Library	Advapi32.lib
Archivo DLL	Advapi32.dll