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

Consulte también

SetupDiCreateDevRegKey

SetupDiOpenDevRegKey