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

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

  • Статья

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

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

Синтаксис

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

Параметры

[out] prdResDes

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

[in] rdResDes

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

[in] ForResource

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

[out, optional] pResourceID

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

[in] ulFlags

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

[in, optional] hMachine

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

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

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

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

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

Комментарии

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

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

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

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

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

Требования

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

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

CM_Get_Next_Res_Des