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

Статья
08/22/2023

Функция CM_Get_Next_Res_Des получает дескриптор следующего дескриптора ресурса указанного типа для логической конфигурации на локальном компьютере.

Синтаксис

CMAPI CONFIGRET CM_Get_Next_Res_Des(
  [out]           PRES_DES    prdResDes,
  [in]            RES_DES     rdResDes,
  [in]            RESOURCEID  ForResource,
  [out, optional] PRESOURCEID pResourceID,
  [in]            ULONG       ulFlags
);

Параметры

[out] prdResDes

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

[in] rdResDes

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

[in] ForResource

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

[out, optional] pResourceID

Указатель на расположение для получения идентификатора типа ресурса, если ForResource указывает ResType_All. Для любого другого значения ForResource вызывающие стороны должны присвоить этому параметру значение NULL.

[in] ulFlags

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

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

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

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

Чтобы перечислить дескрипторы ресурсов логической конфигурации, начните с вызова CM_Get_Next_Res_Des с дескриптором логической конфигурации в качестве аргумента для rdResDes. При этом получается дескриптор первого дескриптора ресурса типа, указанного в ForResource. Затем для каждого последующего вызова CM_Get_Next_Res_Des укажите последний полученный дескриптор дескриптора в качестве аргумента для rdResDes. Повторяйте, пока функция не вернет CR_NO_MORE_RES_DES.

Чтобы получить сведения, хранящиеся в дескрипторове ресурса, вызовите CM_Get_Res_Des_Data.

Чтобы изменить сведения, хранящиеся в дескрипторове ресурса, вызовите CM_Modify_Res_Des.

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

Требования

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

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

CM_Get_Next_Res_Des_Ex

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