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

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

  • Статья

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

Функция CM_Get_Res_Des_Data_Ex извлекает сведения, хранящиеся в дескрипторе ресурсов на локальном или удаленном компьютере.

Синтаксис

CMAPI CONFIGRET CM_Get_Res_Des_Data_Ex(
  [in]           RES_DES  rdResDes,
  [out]          PVOID    Buffer,
  [in]           ULONG    BufferLen,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Параметры

[in] rdResDes

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

[out] Buffer

Адрес буфера для получения содержимого дескриптора ресурса. Требуемый размер буфера следует получить путем вызова CM_Get_Res_Des_Data_Size_Ex.

[in] BufferLen

Заданная вызывающим объектом длина буфера, заданного параметром Buffer.

[in] ulFlags

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

[in, optional] hMachine

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

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

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

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

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

Комментарии

Сведения, возвращаемые буфером, будут отформатированы как одна из структур типов ресурсов, перечисленных в описании CM_Add_Res_Des_Ex, на основе типа ресурса, указанного при вызове CM_Get_Next_Res_Des_Ex для получения дескриптора ресурса.

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

Требования

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

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

CM_Get_Res_Des_Data