Función SetupDiGetHwProfileList (setupapi.h)
La función SetupDiGetHwProfileList recupera una lista de todos los identificadores de perfil de hardware definidos actualmente.
Sintaxis
WINSETUPAPI BOOL SetupDiGetHwProfileList(
[out] PDWORD HwProfileList,
[in] DWORD HwProfileListSize,
[out] PDWORD RequiredSize,
[out, optional] PDWORD CurrentlyActiveIndex
);
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 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. En este caso, se produce un error en la función y una llamada a GetLastError devuelve ERROR_INSUFFICIENT_BUFFER.
[out, optional] CurrentlyActiveIndex
Puntero a una variable de tipo DWORD que recibe el índice del perfil de hardware activo actualmente en la lista de perfiles de hardware recuperado. Este parámetro es opcional y puede ser NULL.
Valor devuelto
La función devuelve TRUE si se realiza correctamente. De lo contrario, devuelve FALSE y el error registrado se puede recuperar mediante una llamada a GetLastError.
Comentarios
Llame a SetupDiGetHwProfileListEx para recuperar los identificadores de perfil de hardware de un equipo remoto.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Microsoft Windows 2000 y versiones posteriores de Windows. |
| Plataforma de destino | Escritorio |
| Encabezado | setupapi.h (incluya Setupapi.h) |
| Library | Setupapi.lib |
| Archivo DLL | Setupapi.dll |