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

Статья
02/26/2024

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

Синтаксис

CMAPI CONFIGRET CM_Free_Log_Conf(
  [in] LOG_CONF lcLogConfToBeFreed,
  [in] ULONG    ulFlags
);

Параметры

[in] lcLogConfToBeFreed

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

CM_Add_Empty_Log_Conf

CM_Add_Empty_Log_Conf_Ex

CM_Get_First_Log_Conf

CM_Get_First_Log_Conf_Ex

CM_Get_Next_Log_Conf

CM_Get_Next_Log_Conf_Ex

[in] ulFlags

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

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

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

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

Вызов CM_Free_Log_Conf может привести к тому, что дескриптора, возвращенные CM_Get_First_Log_Conf и CM_Get_Next_Log_Conf , станут недействительными. Таким образом, если вы хотите получить логические конфигурации после вызова CM_Free_Log_Conf, код должен вызвать CM_Get_First_Log_Conf снова и начать с первой конфигурации.

Обратите внимание, что вызов CM_Free_Log_Conf освобождает конфигурацию, но не дескриптор конфигурации. Чтобы освободить дескриптор, вызовите CM_Free_Log_Conf_Handle.

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

Требования

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

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

CM_Free_Log_Conf_Ex

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