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

Статья
02/23/2024

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

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

Синтаксис

CMAPI CONFIGRET CM_Free_Res_Des_Ex(
  [out]          PRES_DES prdResDes,
  [in]           RES_DES  rdResDes,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Параметры

[out] prdResDes

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

[in] rdResDes

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

CM_Add_Res_Des

CM_Add_Res_Des_Ex

CM_Get_Next_Res_Des

CM_Get_Next_Res_Des_Ex

CM_Modify_Res_Des

CM_Modify_Res_Des_Ex

[in] ulFlags

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

[in, optional] hMachine

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

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

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

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

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

Дескрипторы ресурсов для каждой конфигурации хранятся в массиве. Если указать адрес для prdResDes, то CM_Free_Res_Des возвращает дескриптор ресурса, который был ранее удален в массиве. Если дескриптор, заданный rdResDes , представляет дескриптор ресурса, расположенный сначала в массиве, то prdResDes получает дескриптор для логической конфигурации.

Обратите внимание, что вызов CM_Free_Res_Des_Ex освобождает дескриптор ресурса, но не дескриптор дескриптора. Чтобы освободить дескриптор, вызовите CM_Free_Res_Des_Handle_Ex.

Вызывающие функции должны иметь SeLoadDriverPrivilege. (Привилегии описаны в документации по Microsoft Windows SDK.)

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

Требования

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

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

CM_Free_Res_Des

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