Функция SetupDiLoadClassIcon (setupapi.h)
Функция SetupDiLoadClassIcon загружает большой и мини-значок для указанного класса.
Синтаксис
WINSETUPAPI BOOL SetupDiLoadClassIcon(
[in] const GUID *ClassGuid,
[out, optional] HICON *LargeIcon,
[out, optional] PINT MiniIconIndex
);
Параметры
[in] ClassGuid
Указатель на GUID класса, для которого должны быть загружены значки.
[out, optional] LargeIcon
Указатель на дескриптор значка, который получает значение дескриптора для загруженного большого значка для указанного класса. Этот указатель является необязательным и может иметь значение NULL. Если указатель имеет значение NULL, большой значок не загружается.
[out, optional] MiniIconIndex
Указатель на переменную типа INT, которая получает индекс мини-значка для указанного класса. Мини-значок хранится в кэше мини-значков установщика устройства. Указатель является необязательным и может иметь значение NULL.
Возвращаемое значение
Функция возвращает ЗНАЧЕНИЕ TRUE , если оно выполнено успешно. В противном случае возвращается значение FALSE , а зарегистрированная ошибка может быть получена вызовом Метода GetLastError.
Комментарии
Значки класса либо предопределяются и загружаются из внутреннего кэша установщика устройства, либо загружаются непосредственно из исполняемого файла установщика класса. Эта функция запрашивает значение реестра ICON в разделе указанного класса. Если указано значение ICON , оно указывает, какой мини-значок нужно загрузить.
Если значение ICON отрицательное, абсолютное значение представляет собой предопределенный значок в реестре класса. Список предопределенных мини-значков см. в разделе SetupDiDrawMiniIcon .
Если значение ICON положительное, оно представляет значок в исполняемом образе установщика класса, который будет извлечен. Значение 1 зарезервировано. Эта функция также использует значение реестра INSTALLER32 , а затем значение реестра ENUMPROPPAGES32 для определения исполняемого образа, из которого следует извлечь значки. Дополнительные сведения об этих значениях реестра см. в разделе INF ClassInstall32 Section.
После завершения работы вызывающего абонента с помощью значка вызывающий объект должен вызвать DestroyIcon (описано в документации по Microsoft Windows SDK).
Если параметр LargeIcon указан, но параметр ClassGuid не предоставляет допустимый GUID класса или недопустимое значение реестра Icon класса, SetupDiLoadClassIcon загружает большой значок по умолчанию, возвращает дескриптор для большого значка и, если указан параметр MiniIconIndex , возвращает индекс мини-значка по умолчанию.
Требования
| Минимальная версия клиента | Доступно в Microsoft Windows 2000 и более поздних версиях Windows. |
| Целевая платформа | Персональный компьютер |
| Верхняя часть | setupapi.h (включая Setupapi.h) |
| Библиотека | Setupapi.lib |
| DLL | Setupapi.dll |