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

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

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

Синтаксис

CMAPI CONFIGRET CM_Get_Res_Des_Data_Size_Ex(
  [out]          PULONG   pulSize,
  [in]           RES_DES  rdResDes,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Параметры

[out] pulSize

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

[in] rdResDes

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

[in] ulFlags

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

[in, optional] hMachine

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

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

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

Комментарии

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

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

Требования

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

CM_Get_Res_Des_Data_Size