Función SetupDiGetHwProfileListExA (setupapi.h)
La función SetupDiGetHwProfileListEx recupera una lista de todos los identificadores de perfil de hardware definidos actualmente en un equipo local o remoto.
Sintaxis
WINSETUPAPI BOOL SetupDiGetHwProfileListExA(
[out] PDWORD HwProfileList,
[in] DWORD HwProfileListSize,
[out] PDWORD RequiredSize,
[out, optional] PDWORD CurrentlyActiveIndex,
[in, optional] PCSTR MachineName,
PVOID Reserved
);
Parámetros
[out] HwProfileList
Puntero a una matriz para recibir la lista de identificadores de perfil de hardware definidos actualmente.
[in] HwProfileListSize
Número de DWORD en el búfer de HwProfileList.
[out] RequiredSize
Puntero a una variable de tipo DWORD que recibe el número de perfiles de hardware definidos actualmente. Si el número es mayor que HwProfileListSize, la lista se trunca para ajustarse al tamaño de la matriz. El valor devuelto en RequiredSize indica el tamaño de matriz necesario para almacenar toda la lista de perfiles de hardware.
[out, optional] CurrentlyActiveIndex
Puntero a una variable que recibe el índice del perfil de hardware activo actualmente en la lista de perfiles de hardware recuperado. Este parámetro es opcional y se puede NULL.
[in, optional] MachineName
Puntero a una cadena terminada en NULL que contiene el nombre de un sistema remoto para el que se va a recuperar la lista de identificadores de perfil de hardware. Este parámetro es opcional y se puede NULL. Si este parámetro es null, la lista se recupera para el sistema local.
Cautela
No se admite el uso de esta función para acceder a máquinas remotas a partir de Windows 8 y Windows Server 2012, ya que esta funcionalidad se ha quitado.
Reserved
Debe ser null.
Valor devuelto
La función devuelve TRUE si se ejecuta correctamente. De lo contrario, devuelve FALSE y se puede recuperar el error registrado realizando una llamada a GetLastError. Si el tamaño necesario es mayor que HwProfileListSize, SetupDiGetHwProfileListEx devuelve FALSE y una llamada a GetLastError devuelve ERROR_INSUFFICIENT_BUFFER.
Observaciones
Nota
El encabezado setupapi.h define SetupDiGetHwProfileListEx 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 | Disponible en Microsoft Windows 2000 y versiones posteriores de Windows. |
| de la plataforma de destino de |
Escritorio |
| encabezado de |
setupapi.h (incluya Setupapi.h) |
| biblioteca de |
Setupapi.lib |