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

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

  • Статья

Функция CM_Modify_Res_Des изменяет указанный дескриптор ресурса на локальном компьютере.

Синтаксис

CMAPI CONFIGRET CM_Modify_Res_Des(
  [out] PRES_DES   prdResDes,
  [in]  RES_DES    rdResDes,
  [in]  RESOURCEID ResourceID,
  [in]  PCVOID     ResourceData,
  [in]  ULONG      ResourceLen,
  [in]  ULONG      ulFlags
);

Параметры

[out] prdResDes

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

[in] rdResDes

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

CM_Add_Res_Des

CM_Add_Res_Des_Ex

CM_Get_Next_Res_Des

CM_Get_Next_Res_Des_Ex

CM_Modify_Res_Des

CM_Modify_Res_Des_Ex

[in] ResourceID

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

[in] ResourceData

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

[in] ResourceLen

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

[in] ulFlags

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

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

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

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

Комментарии

Предоставленные вызывающим дескриптором ресурса данные заменяют существующие данные. Значения, указанные для ResourceID и ResourceLen , не должны соответствовать существующему дескриптору ресурса.

Если для ResourceID задано значение ResType_ClassSpecific, то указанный дескриптор ресурса должен быть последним, связанным с логической конфигурацией.

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

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

Требования

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

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

CM_Modify_Res_Des_Ex