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

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

  • Статья

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

Синтаксис

CMAPI CONFIGRET CM_Free_Res_Des(
  [out] PRES_DES prdResDes,
  [in]  RES_DES  rdResDes,
  [in]  ULONG    ulFlags
);

Параметры

[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

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

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

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

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

Комментарии

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

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

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

Требования

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

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

CM_Free_Res_Des_Ex