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

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

  • Статья

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

Функция CM_Get_Device_ID_List_Ex извлекает список идентификаторов экземпляров устройств на локальном или удаленном компьютере.

Синтаксис

CMAPI CONFIGRET CM_Get_Device_ID_List_ExA(
  [in, optional] PCSTR    pszFilter,
  [out]          PZZSTR   Buffer,
  [in]           ULONG    BufferLen,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Параметры

[in, optional] pszFilter

Предоставленный вызывающим оператором указатель на строку символов, задающую подмножество идентификаторов экземпляров устройства компьютера или NULL. См. следующее описание ulFlags.

[out] Buffer

Адрес буфера для получения набора строк идентификаторов экземпляра устройства, завершаемых значением NULL. Конец набора завершается дополнительным значением NULL. Требуемый размер буфера следует получить путем вызова CM_Get_Device_ID_List_Size_Ex.

[in] BufferLen

Указанная вызывающим объектом длина буфера, заданного параметром Buffer, в символах.

[in] ulFlags

Один из необязательных битовых флагов, предоставляемых вызывающим абонентом, который задает фильтры поиска. Если флаги не указаны, функция предоставляет все идентификаторы экземпляров для всех экземпляров устройства. Список битовых флагов см. в описании ulFlags для CM_Get_Device_ID_List.

[in, optional] hMachine

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

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

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

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

Комментарии

Сведения об идентификаторах экземпляров устройств см. в разделе Строки идентификации устройств.

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

Требования

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