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

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

  • Статья

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

Функция CM_Add_Res_Des_Ex добавляет дескриптор ресурсов в логическую конфигурацию. Логическая конфигурация может находиться на локальном или удаленном компьютере.

Синтаксис

CMAPI CONFIGRET CM_Add_Res_Des_Ex(
  [out, optional] PRES_DES   prdResDes,
  [in]            LOG_CONF   lcLogConf,
  [in]            RESOURCEID ResourceID,
  [in]            PCVOID     ResourceData,
  [in]            ULONG      ResourceLen,
  [in]            ULONG      ulFlags,
  [in, optional]  HMACHINE   hMachine
);

Параметры

[out, optional] prdResDes

Указатель на расположение для получения дескриптора нового ресурса.

[in] lcLogConf

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

CM_Add_Empty_Log_Conf

CM_Add_Empty_Log_Conf_Ex

CM_Get_First_Log_Conf

CM_Get_First_Log_Conf_Ex

CM_Get_Next_Log_Conf

CM_Get_Next_Log_Conf_Ex

[in] ResourceID

Идентификатор типа ресурса, предоставленный вызывающим абонентом, который определяет тип структуры, предоставляемый ResourceData. Это должна быть одна из ResType_ префиксных констант, определенных в Cfgmgr32.h.

[in] ResourceData

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

ResourceID Параметр Структура ресурсов
ResType_BusNumber

BUSNUMBER_RESOURCE
ResType_ClassSpecific

CS_RESOURCE
ResType_DevicePrivate

DEVPRIVATE_RESOURCE
ResType_DMA

DMA_RESOURCE
ResType_IO

IO_RESOURCE
ResType_IRQ

IRQ_RESOURCE
ResType_Mem

MEM_RESOURCE
ResType_MfCardConfig

MFCARD_RESOURCE
ResType_PcCardConfig

PCCARD_RESOURCE

[in] ResourceLen

Заданная вызывающим элементом длина структуры, на которую указывает ResourceData.

[in] ulFlags

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

[in, optional] hMachine

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

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

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

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

Примечание Начиная с Windows 8, CM_Add_Res_Des_Ex возвращает CR_CALL_NOT_IMPLEMENTED при использовании в сценарии Wow64. Чтобы запросить сведения об аппаратных ресурсах на локальном компьютере, необходимо реализовать собственную архитектуру версию приложения с помощью API аппаратных ресурсов. Например: приложение AMD64 для систем AMD64.
 

Комментарии

Вызывающие CM_Add_Res_Des_Ex должны вызывать CM_Free_Res_Des_Handle , чтобы освободить дескриптор ресурса, после того как он больше не нужен.

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

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

Требования

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

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

CM_Add_Res_Des

CM_Free_Res_Des_Handle