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


функция CM_Get_Device_Interface_List_SizeA (cfgmgr32.h)

Функция CM_Get_Device_Interface_List_Size извлекает размер буфера, который должен быть передан функции CM_Get_Device_Interface_List .

Синтаксис

CMAPI CONFIGRET CM_Get_Device_Interface_List_SizeA(
  [out]          PULONG      pulLen,
  [in]           LPGUID      InterfaceClassGuid,
  [in, optional] DEVINSTID_A pDeviceID,
  [in]           ULONG       ulFlags
);

Параметры

[out] pulLen

Предоставленный вызывающим объектом указатель на расположение, которое получает необходимую длину (в символах) буфера для хранения нескольких строк Юникода, которые будут возвращены CM_Get_Device_Interface_List.

[in] InterfaceClassGuid

Предоставляет ИДЕНТИФИКАТОР GUID, идентифицирующий класс интерфейса устройства.

[in, optional] pDeviceID

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

[in] ulFlags

Содержит один из следующих флагов, предоставленных вызывающим абонентом:

Значение Значение
CM_GET_DEVICE_INTERFACE_LIST_ALL_DEVICES
Функция предоставляет размер списка, содержащего интерфейсы устройств, связанные со всеми устройствами, которые соответствуют указанному идентификатору GUID и идентификатору экземпляра устройства, если таковые есть.
CM_GET_DEVICE_INTERFACE_LIST_PRESENT
Функция предоставляет размер списка, содержащего интерфейсы устройств, связанные с активными устройствами, которые соответствуют указанному идентификатору GUID и идентификатору экземпляра устройства, если таковые имеются.

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

Если операция выполнена успешно, функция возвращает CR_SUCCESS. В противном случае возвращается один из кодов ошибок с префиксом CR_ , как определено в Cfgmgr32.h.

Комментарии

Примечание

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

Требования

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

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

CM_Get_Device_Interface_List