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

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

  • Статья

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

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

Синтаксис

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

Параметры

[in] ulEnumIndex

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

[out] Buffer

Адрес буфера для получения имени перечислителя. Этот буфер должен быть MAX_DEVICE_ID_LEN размера (или задайте для параметра Buffer значение 0 и получить фактическую длину имени в расположении, на который ссылается 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