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

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

  • Статья

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

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

Синтаксис

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

Параметры

[out, optional] plcLogConf

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

[in] dnDevInst

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

[in] ulFlags

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

[in, optional] hMachine

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

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

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

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

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

Комментарии

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

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

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

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

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

Требования

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

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

CM_Add_Empty_Log_Conf_Ex

CM_Free_Log_Conf_Ex

CM_Free_Log_Conf_Handle

CM_Get_Child_Ex

CM_Get_First_Log_Conf