Función EnumDependentServicesA (winsvc.h)

Artículo
03/08/2023

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.

Valor	Significado
SERVICE_ACTIVE 0x00000001	Enumera los servicios que se encuentran en los siguientes estados: SERVICE_START_PENDING, SERVICE_STOP_PENDING, SERVICE_RUNNING, SERVICE_CONTINUE_PENDING, SERVICE_PAUSE_PENDING y SERVICE_PAUSED.
SERVICE_INACTIVE 0x00000002	Enumera los servicios que están en estado SERVICE_STOPPED .
SERVICE_STATE_ALL 0x00000003	Combina los siguientes estados: SERVICE_ACTIVE y SERVICE_INACTIVE.

[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
ERROR_ACCESS_DENIED	El identificador no tiene derecho de acceso SERVICE_ENUMERATE_DEPENDENTS .
ERROR_INVALID_HANDLE	El identificador especificado no es válido.
ERROR_INVALID_PARAMETER	Un parámetro especificado no es válido.
ERROR_MORE_DATA	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