функция CM_Enumerate_EnumeratorsA (cfgmgr32.h)
Функция 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 |