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

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

  • Статья

Функция SetupDiGetClassImageListEx создает список растровых изображений для каждого класса, установленного в локальной или удаленной системе.

Синтаксис

WINSETUPAPI BOOL SetupDiGetClassImageListExA(
  [out]          PSP_CLASSIMAGELIST_DATA ClassImageListData,
  [in, optional] PCSTR                   MachineName,
                 PVOID                   Reserved
);

Параметры

[out] ClassImageListData

Указатель на SP_CLASSIMAGELIST_DATA структуру для получения сведений о списке изображений класса, включая дескриптор списка изображений. Поле cbSize этой структуры должно быть инициализировано с размером структуры (в байтах) перед вызовом этой функции, в противном случае произойдет сбой.

[in, optional] MachineName

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

Внимание!

Использование этой функции для доступа к удаленным компьютерам не поддерживается начиная с Windows 8 и Windows Server 2012, так как эта функция была удалена.

Reserved

Должен иметь значение NULL.

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

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

Комментарии

Список образов, созданный этой функцией, должен быть уничтожен путем вызова SetupDiDeclassImageList.

Примечание Значки для конкретных классов на удаленном компьютере могут отображаться только в том случае, если класс также присутствует на локальном компьютере. Таким образом, если удаленный компьютер имеет класс X, но класс X не установлен локально, будет возвращен универсальный (неизвестный) значок.
 

Примечание

Заголовок setupapi.h определяет SetupDiGetClassImageListEx как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

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

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

SetupDiDeclassImageList

SetupDiGetClassImageList