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

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

Функция CM_Add_ID_Ex добавляет идентификатор устройства (если он еще отсутствует) в список идентификаторов оборудования экземпляра устройства или совместимый список идентификаторов на локальном или удаленном компьютере.

Синтаксис

CMAPI CONFIGRET CM_Add_ID_ExW(
  [in]           DEVINST  dnDevInst,
  [in]           PWSTR    pszID,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Параметры

[in] dnDevInst

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

hMachine

.

[in] pszID

Предоставленный вызывающим элементом указатель на строку идентификатора устройства, завершаемую null.

[in] ulFlags

Константу флага, предоставляемую вызывающим абонентом, которая указывает список, в который должен быть добавлен предоставленный идентификатор устройства. Допустимы следующие константы флага.

Пометка константы	Определение
CM_ADD_ID_COMPATIBLE	Указанный идентификатор устройства должен быть добавлен в список совместимых идентификаторов конкретного экземпляра устройства.
CM_ADD_ID_HARDWARE	Указанный идентификатор устройства должен быть добавлен в список идентификаторов оборудования конкретного экземпляра устройства.

[in, optional] hMachine

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

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

 

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

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

Комментарии

Каждый добавленный идентификатор устройства считается менее совместимым, чем идентификаторы, уже существующие в указанном списке. Сведения об идентификаторах устройств, аппаратных идентификаторах и совместимых идентификаторах см. в разделе Строки идентификации устройств.

Вызывающие функции должны иметь SeLoadDriverPrivilege. (Привилегии описаны в документации по Microsoft Windows SDK.)

Сведения об использовании дескрипторов экземпляров устройства, привязанных к локальному или удаленному компьютеру, см. в разделе CM_Get_Child_Ex.

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

Требования

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

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

CM_Add_ID

CM_Get_Child_Ex