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

Статья
11/20/2024

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

Синтаксис

WINSETUPAPI HDEVINFO SetupDiCreateDeviceInfoListExA(
  [in, optional] const GUID *ClassGuid,
  [in, optional] HWND       hwndParent,
  [in, optional] PCSTR      MachineName,
                 PVOID      Reserved
);

Параметры

[in, optional] ClassGuid

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

[in, optional] hwndParent

Дескриптор окна верхнего уровня, используемый для любого пользовательского интерфейса, связанного с действиями, не связанными с устройствами (например, диалоговое окно выбора устройства, использующее список драйверов глобального класса). Этот дескриптор является необязательным и может быть null. Если определенное окно верхнего уровня не требуется, задайте hwndParent значение NULL.

[in, optional] MachineName

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

Осторожность

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

Reserved

Должен быть null.

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

Функция возвращает дескриптор пустому набору сведений об устройстве, если он выполнен успешно. В противном случае возвращается INVALID_HANDLE_VALUE. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.

Замечания

Вызывающий объект этой функции должен удалить возвращенный набор сведений об устройстве, если он больше не нужен путем вызова SetupDiDeeviceDeviceInfoList.

Если набор сведений об устройстве предназначен для устройств на удаленном компьютере ( machineNameMachineName не NULL), все последующие операции с этим набором или любой из его элементов должны использовать подпрограммы, поддерживающие наборы сведений об устройстве с удаленными элементами. Подпрограммы SetupDiXxx, которые не предоставляют эту поддержку, такие как SetupDiCallClassInstaller, имеют инструкцию для этого эффекта на своей справочной странице.

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно в Microsoft Windows 2000 и более поздних версиях Windows.
целевая платформа	Настольный
заголовка	setupapi.h (include Setupapi.h)
библиотеки	Setupapi.lib

См. также

SetupDiCreateDeviceInfoList

SetupDiDetoDeviceInfoList

SetupDiGetDeviceInfoListDetail

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