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

Статья
02/26/2024

Функция CM_Enumerate_Enumerators перечисляет перечислители устройств локального компьютера, предоставляя имена каждого перечислителя.

Синтаксис

CMAPI CONFIGRET CM_Enumerate_EnumeratorsA(
  [in]      ULONG  ulEnumIndex,
  [out]     PSTR   Buffer,
  [in, out] PULONG pulLength,
  [in]      ULONG  ulFlags
);

Параметры

[in] ulEnumIndex

Индекс, предоставленный вызывающим абонентом, в списке перечислителей устройств на компьютере. Дополнительные сведения см. в следующем разделе Примечаний .

[out] Buffer

Адрес буфера для получения имени перечислителя. Этот буфер должен быть MAX_DEVICE_ID_LEN размера (или задайте значение Buffer равным нулю и получить фактическую длину имени в расположении, на который ссылается puLength).

[in, out] pulLength

Указанный вызывающим объектом адрес расположения для хранения размера буфера. Вызывающий объект предоставляет длину буфера, на который указывает buffer. Функция заменяет это значение фактическим размером строки имени перечислителя. Если длина буфера, предоставленного вызывающим объектом, слишком мала, функция предоставляет требуемый размер буфера и возвращает CR_BUFFER_SMALL.

[in] ulFlags

Не используется, должно быть равно нулю.

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

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

Чтобы перечислить перечислители устройств локального компьютера, вызовите CM_Enumerate_Enumerators несколько раз, начиная со значения индекса ulEnumIndex , равного нулю. и увеличивает значение индекса с каждым последующим вызовом, пока функция не вернет CR_NO_SUCH_VALUE.

После получения имен перечислителя имена можно использовать в качестве входных данных для CM_Get_Device_ID_List.

Требования

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

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

CM_Enumerate_Enumerators_Ex

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