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


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

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

Синтаксис

CMAPI CONFIGRET CM_Get_Res_Des_Data_Size(
  [out] PULONG  pulSize,
  [in]  RES_DES rdResDes,
  [in]  ULONG   ulFlags
);

Параметры

[out] pulSize

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

[in] rdResDes

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

[in] ulFlags

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

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

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

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

Комментарии

Возвращаемое значение размера представляет размер соответствующей структуры ресурсов (см . CM_Add_Res_Des). Если дескриптор ресурса находится в списке требований к ресурсам, возвращаемый размер включает как размер структуры ресурсов, так и пространство, выделенное для связанных массивов диапазонов.

Требования

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

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

CM_Get_Res_Des_Data_Size_Ex