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

Статья
03/08/2023

[Эта функция устарела и не должна использоваться.]

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

Синтаксис

CMAPI CONFIGRET CM_Get_HW_Prof_Flags_ExA(
  [in]           DEVINSTID_A pDeviceID,
  [in]           ULONG       ulHardwareProfile,
  [out]          PULONG      pulValue,
  [in]           ULONG       ulFlags,
  [in, optional] HMACHINE    hMachine
);

Параметры

[in] pDeviceID

Указатель на строку, завершающуюся значением NULL, которая содержит идентификатор экземпляра устройства, для которого извлекаются флаги конфигурации для конкретного профиля оборудования.

[in] ulHardwareProfile

Переменная типа ULONG, указывающая идентификатор профиля оборудования, для которого извлекаются флаги конфигурации. Если этот параметр равен нулю, эта функция получает флаги конфигурации для текущего профиля оборудования.

[out] pulValue

Указатель на переменную типа ULONG, предоставляемую вызывающим абонентом, которая получает ноль или побитовое значение ИЛИ следующих флагов конфигурации, определенных в Regstr.h:

CSCONFIGFLAG_BITS

Побитовое ИЛИ других флагов CSCONFIGFLAG_Xxx.

CSCONFIGFLAG_DISABLE

Экземпляр устройства отключен в указанном профиле оборудования.

CSCONFIGFLAG_DO_NOT_CREATE

Профиль оборудования не поддерживает указанный экземпляр устройства.

CSCONFIGFLAG_DO_NOT_START

Устройство не может быть запущено в указанном аппаратном профиле.

[in] ulFlags

Зарезервировано для внутреннего использования. Необходимо задать нулевое значение.

[in, optional] hMachine

Дескриптор компьютера, возвращаемый вызовом CM_Connect_Machine или NULL. Если для этого параметра задано значение NULL, CM_Get_HW_Prof_Flags_Ex извлекает флаги конфигурации на локальном компьютере.

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

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

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

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

Примечание

Заголовок cfgmgr32.h определяет CM_Get_HW_Prof_Flags_Ex в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования


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

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

CM_Get_HW_Prof_Flags

SetupDiGetHwProfileFriendlyNameEx

SetupDiGetHwProfileListEx

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