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

Статья
08/22/2023

[Начиная с Windows 8 и Windows Server 2012 эта функция устарела. Вместо этого используйте CM_Enumerate_Enumerators .]

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

Синтаксис

CMAPI CONFIGRET CM_Enumerate_Enumerators_ExA(
  [in]           ULONG    ulEnumIndex,
  [out]          PSTR     Buffer,
  [in, out]      PULONG   pulLength,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Параметры

[in] ulEnumIndex

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

[out] Buffer

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

[in, out] pulLength

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

[in] ulFlags

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

[in, optional] hMachine

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

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

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

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

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

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

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

Требования


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

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

CM_Enumerate_Enumerators

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