Función CloseServiceHandle (winsvc.h)

Artículo
03/04/2024

Cierra un identificador de un administrador de control de servicio o un objeto de servicio.

Sintaxis

BOOL CloseServiceHandle(
  [in] SC_HANDLE hSCObject
);

Parámetros

[in] hSCObject

Identificador del objeto del administrador de controles de servicio o del objeto de servicio que se va a cerrar. La función OpenSCManager devuelve los identificadores de los objetos del administrador de controles de servicio y la función OpenSCManager devuelve los identificadores de los objetos de servicio mediante la función OpenService o CreateService .

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 el siguiente código de error. Otros códigos de error se pueden establecer mediante funciones del Registro a las que llama el administrador de control de servicio.

Código devuelto	Descripción
ERROR_INVALID_HANDLE	El identificador especificado no es válido.

Comentarios

La función CloseServiceHandle no destruye el objeto del administrador de controles de servicio al que hace referencia el identificador. No se puede destruir un objeto de administrador de control de servicios. Un objeto de servicio se puede destruir llamando a la función DeleteService .

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