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

Статья
08/22/2023

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

Синтаксис

CMAPI CONFIGRET CM_Get_First_Log_Conf(
  [out, optional] PLOG_CONF plcLogConf,
  [in]            DEVINST   dnDevInst,
  [in]            ULONG     ulFlags
);

Параметры

[out, optional] plcLogConf

Адрес расположения для получения дескриптора для логической конфигурации или NULL. См. следующий раздел Примечаний .

[in] dnDevInst

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

[in] ulFlags

Значение флага вызывающего объекта, указывающее тип запрашиваемой логической конфигурации. Необходимо указать один из флагов в следующей таблице.

Флаги типов конфигурации	Определения
BASIC_LOG_CONF	Вызывающий объект запрашивает основные сведения о конфигурации .
FILTERED_LOG_CONF	Вызывающий объект запрашивает отфильтрованные сведения о конфигурации .
ALLOC_LOG_CONF	Вызывающий объект запрашивает сведения о выделенной конфигурации .
BOOT_LOG_CONF	Вызывающий объект запрашивает сведения о конфигурации загрузки .
FORCED_LOG_CONF	Вызывающий объект запрашивает сведения о принудительной конфигурации .
OVERRIDE_LOG_CONF	Вызывающий объект запрашивает сведения о конфигурации переопределения .

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

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

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

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

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

Если CM_Get_First_Log_Conf вызывается с параметром plcLogConf со значением NULL, дескриптор не возвращается. Это позволяет использовать возвращаемое состояние, чтобы определить, существует ли конфигурация без необходимости впоследствии освобождать дескриптор.

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

Требования

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