Поделиться через


Функция SetupDiGetHwProfileList (setupapi.h)

Функция SetupDiGetHwProfileList извлекает список всех определенных в настоящее время идентификаторов профилей оборудования.

Синтаксис

WINSETUPAPI BOOL SetupDiGetHwProfileList(
  [out]           PDWORD HwProfileList,
  [in]            DWORD  HwProfileListSize,
  [out]           PDWORD RequiredSize,
  [out, optional] PDWORD CurrentlyActiveIndex
);

Параметры

[out] HwProfileList

Указатель на массив для получения списка определенных в настоящее время идентификаторов профилей оборудования.

[in] HwProfileListSize

Количество DWORD в буфере HwProfileList .

[out] RequiredSize

Указатель на переменную типа DWORD, которая получает определенное количество профилей оборудования. Если число больше , чем HwProfileListSize, список усекается в соответствии с размером массива. Значение, возвращаемое в поле RequiredSize , указывает размер массива, необходимый для хранения всего списка профилей оборудования. В этом случае функция завершается сбоем, и вызов GetLastError возвращает ERROR_INSUFFICIENT_BUFFER.

[out, optional] CurrentlyActiveIndex

Указатель на переменную типа DWORD, которая получает индекс активного в настоящее время профиля оборудования из полученного списка профилей оборудования. Этот параметр является необязательным и может иметь значение NULL.

Возвращаемое значение

Функция возвращает значение TRUE в случае успешного выполнения. В противном случае возвращается значение FALSE , а зарегистрированная ошибка может быть получена путем вызова Метода GetLastError.

Комментарии

Вызовите SetupDiGetHwProfileListEx , чтобы получить идентификаторы профилей оборудования для удаленного компьютера.

Требования

Требование Значение
Минимальная версия клиента Доступно в Microsoft Windows 2000 и более поздних версиях Windows.
Целевая платформа Персональный компьютер
Верхняя часть setupapi.h (включая Setupapi.h)
Библиотека Setupapi.lib
DLL Setupapi.dll

См. также раздел

SetupDiCreateDevRegKey

SetupDiOpenDevRegKey