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

Статья
02/23/2024

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

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

Синтаксис

CMAPI CONFIGRET CM_Add_Empty_Log_Conf_Ex(
  [out]          PLOG_CONF plcLogConf,
  [in]           DEVINST   dnDevInst,
  [in]           PRIORITY  Priority,
  [in]           ULONG     ulFlags,
  [in, optional] HMACHINE  hMachine
);

Параметры

[out] plcLogConf

Указатель на расположение для получения дескриптора пустой логической конфигурации.

[in] dnDevInst

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

[in] Priority

Значение приоритета конфигурации, предоставленное вызывающим абонентом. Список значений см. в описании приоритетадля CM_Add_Empty_Log_Conf.

[in] ulFlags

Флаги, предоставляемые вызывающим абонентом, указывающие тип логической конфигурации. Список флагов см. в описании ulFlags description для CM_Add_Empty_Log_Conf.

[in, optional] hMachine

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

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

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

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

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

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

Чтобы удалить логическую конфигурацию, созданную CM_Add_Empty_Log_Conf_Ex, вызовите CM_Free_Log_Conf_Ex.

Дескриптор, полученный в plcLogConf , должен быть явно освобожден путем вызова CM_Free_Log_Conf_Handle.

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

Сведения об использовании дескрипторов экземпляров устройства, привязанных к локальному или удаленному компьютеру, см. в разделе CM_Get_Child_Ex.

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

Требования

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