функция CM_Get_First_Log_Conf (cfgmgr32.h)
Функция 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.
Комментарии
Вызов 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 |