Función CloseServiceHandle (winsvc.h)
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 |
|---|---|
|
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 |