Función EnumDependentServicesA (winsvc.h)
Recupera el nombre y el estado de cada servicio que depende del servicio especificado; es decir, el servicio especificado debe ejecutarse antes de que se puedan ejecutar los servicios dependientes.
Sintaxis
BOOL EnumDependentServicesA(
[in] SC_HANDLE hService,
[in] DWORD dwServiceState,
[out, optional] LPENUM_SERVICE_STATUSA lpServices,
[in] DWORD cbBufSize,
[out] LPDWORD pcbBytesNeeded,
[out] LPDWORD lpServicesReturned
);
Parámetros
[in] hService
Identificador del servicio. La función OpenService o CreateService devuelve este identificador y debe tener el derecho de acceso SERVICE_ENUMERATE_DEPENDENTS . Para obtener más información, consulte Derechos de acceso y seguridad de servicio.
[in] dwServiceState
Estado de los servicios que se van a enumerar. Este parámetro puede ser uno de los valores siguientes.
[out, optional] lpServices
Puntero a una matriz de estructuras de ENUM_SERVICE_STATUS que recibe la información de estado del nombre y del servicio para cada servicio dependiente de la base de datos. El búfer debe ser lo suficientemente grande como para contener las estructuras, además de las cadenas a las que apuntan sus miembros.
El orden de los servicios de esta matriz es el inverso del orden de inicio de los servicios. En otras palabras, el primer servicio de la matriz es el que se iniciaría por última vez y el último servicio de la matriz es el que se iniciaría primero.
El tamaño máximo de esta matriz es de 64 000 bytes. Para determinar el tamaño necesario, especifique NULL para este parámetro y 0 para el parámetro cbBufSize . Se producirá un error en la función y GetLastError devolverá ERROR_MORE_DATA. El parámetro pcbBytesNeeded recibirá el tamaño necesario.
[in] cbBufSize
Tamaño del búfer al que apunta el parámetro lpServices , en bytes.
[out] pcbBytesNeeded
Puntero a una variable que recibe el número de bytes necesarios para almacenar la matriz de entradas de servicio. La variable solo recibe este valor si el búfer al que apunta lpServices es demasiado pequeño, indicado por error de función y el error de ERROR_MORE_DATA ; de lo contrario, el contenido de pcbBytesNeeded no está definido.
[out] lpServicesReturned
Puntero a una variable que recibe el número de entradas de servicio devueltas.
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. Otros códigos de error pueden establecerse mediante las funciones del Registro a las que llama el administrador de control de servicio.
| Código devuelto | Descripción |
|---|---|
|
El identificador no tiene derecho de acceso SERVICE_ENUMERATE_DEPENDENTS . |
|
El identificador especificado no es válido. |
|
Un parámetro especificado no es válido. |
|
El búfer al que apunta lpServices no es lo suficientemente grande. La función establece la variable a la que apunta lpServicesReturned al número real de entradas de servicio almacenadas en el búfer. La función establece la variable a la que apunta pcbBytesNeeded en el número de bytes necesarios para almacenar todas las entradas de servicio. |
Comentarios
Las entradas de servicios devueltos se ordenan en el orden inverso del orden de inicio, con el orden de grupo en cuenta. Si necesita detener los servicios dependientes, puede usar el orden de las entradas escritas en el búfer lpServices para detener los servicios dependientes en el orden adecuado.
Ejemplos
Para obtener un ejemplo, consulte Detener un servicio.
Nota
El encabezado winsvc.h define EnumDependentServices como un alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.
Requisitos
| 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 |