Функция 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 |