Función EnumServicesStatusExA (winsvc.h)
Enumera los servicios de la base de datos del administrador de control de servicios especificada. Se proporciona el nombre y el estado de cada servicio, junto con datos adicionales basados en el nivel de información especificado.
Sintaxis
BOOL EnumServicesStatusExA(
[in] SC_HANDLE hSCManager,
[in] SC_ENUM_TYPE InfoLevel,
[in] DWORD dwServiceType,
[in] DWORD dwServiceState,
[out, optional] LPBYTE lpServices,
[in] DWORD cbBufSize,
[out] LPDWORD pcbBytesNeeded,
[out] LPDWORD lpServicesReturned,
[in, out, optional] LPDWORD lpResumeHandle,
[in, optional] LPCSTR pszGroupName
);
Parámetros
[in] hSCManager
Identificador de la base de datos del administrador de control de servicios. El función OpenSCManager devuelve este identificador y debe tener el derecho de acceso SC_MANAGER_ENUMERATE_SERVICE. Para obtener más información, consulte derechos de acceso y seguridad del servicio.
[in] InfoLevel
Atributos de servicio que se van a devolver. Use SC_ENUM_PROCESS_INFO para recuperar la información de nombre y estado del servicio para cada servicio de la base de datos. El parámetro lpServices es un puntero a un búfer que recibe una matriz de estructuras de ENUM_SERVICE_STATUS_PROCESS. El búfer debe ser lo suficientemente grande como para contener las estructuras, así como las cadenas a las que apuntan sus miembros.
Actualmente, no se definen otros niveles de información.
[in] dwServiceType
Tipo de servicios que se van a enumerar. Este parámetro puede ser uno o varios de los siguientes valores.
| Valor | Significado |
|---|---|
|
Servicios de tipo SERVICE_KERNEL_DRIVER y SERVICE_FILE_SYSTEM_DRIVER. |
|
Servicios de controladores del sistema de archivos. |
|
Servicios de controladores. |
|
Servicios de tipo SERVICE_WIN32_OWN_PROCESS y SERVICE_WIN32_SHARE_PROCESS. |
|
Servicios que se ejecutan en sus propios procesos. |
|
Servicios que comparten un proceso con uno o más servicios. Para obtener más información, consulte Programas de servicio. |
[in] dwServiceState
Estado de los servicios que se van a enumerar. Este parámetro puede ser uno de los siguientes valores.
[out, optional] lpServices
Puntero al búfer que recibe la información de estado. El formato de estos datos depende del valor del parámetro
El tamaño máximo de esta matriz es de 256 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 pcbBytesNeededed recibirá el tamaño necesario.
Windows Server 2003 y Windows XP: El tamaño máximo de esta matriz es de 64 000 bytes. Este límite se incrementó a partir de Windows Server 2003 con SP1 y Windows XP con SP2.
[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 devolver las entradas de servicio restantes, si el búfer es demasiado pequeño.
[out] lpServicesReturned
Puntero a una variable que recibe el número de entradas de servicio devueltas.
[in, out, optional] lpResumeHandle
Puntero a una variable que, en la entrada, especifica el punto inicial de la enumeración. Debe establecer este valor en cero la primera vez que se llama a la función EnumServicesStatusEx. En la salida, este valor es cero si la función se realiza correctamente. Sin embargo, si la función devuelve cero y la función getLastError
[in, optional] pszGroupName
Nombre del grupo de orden de carga. Si este parámetro es una cadena, los únicos servicios enumerados son los que pertenecen al grupo que tiene el nombre especificado por la cadena. Si este parámetro es una cadena vacía, solo se enumeran los servicios que no pertenecen a ningún grupo. Si este parámetro es NULL, se omite la pertenencia a grupos y se enumeran todos los servicios.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es distinto de cero.
Si se produce un error en la función, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError. Se pueden devolver los errores siguientes.
| Código devuelto | Descripción |
|---|---|
|
El identificador no tiene derecho de acceso SC_MANAGER_ENUMERATE_SERVICE. |
|
El búfer es demasiado pequeño. No se pueden devolver todos los datos de la base de datos activa. El parámetro pcbBytesNeededed contiene el número de bytes necesarios para recibir las entradas restantes. |
|
Se usó un valor de parámetro no válido. |
|
El identificador no es válido. |
|
El parámetro |
|
El sistema está apagando; no se puede llamar a esta función. |
Observaciones
Si el autor de la llamada no tiene el derecho de acceso SERVICE_QUERY_STATUS a un servicio, el servicio se omite silenciosamente de la lista de servicios devueltos al cliente.
Nota
El encabezado winsvc.h define EnumServicesStatusEx como 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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows XP [solo aplicaciones de escritorio] |
| servidor mínimo admitido | Windows Server 2003 [solo aplicaciones de escritorio] |
| de la plataforma de destino de |
Windows |
| encabezado de |
winsvc.h (incluya Windows.h) |
| biblioteca de |
Advapi32.lib |
| DLL de |
Advapi32.dll |