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

Статья
11/20/2024

[Начиная с Windows 8 и Windows Server 2012 эта функция не рекомендуется использовать.

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

Синтаксис

CMAPI CONFIGRET CM_Get_HW_Prof_FlagsA(
  [in]  DEVINSTID_A pDeviceID,
  [in]  ULONG       ulHardwareProfile,
  [out] PULONG      pulValue,
  [in]  ULONG       ulFlags
);

Параметры

[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

Зарезервировано для внутреннего использования. Должно быть задано равно нулю.

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

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

Замечания

Чтобы получить список идентификаторов профилей оборудования, определенных на локальном компьютере, вызовите SetupDiGetHwProfileList.

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

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно в Microsoft Windows 2000 и более поздних версиях Windows.
целевая платформа	Настольный
заголовка	cfgmgr32.h (include Cfgmgr32.h)
библиотеки	Cfgmgr32.lib

См. также

CM_Get_HW_Prof_Flags_Ex

SetupDiGetHwProfileFriendlyName

SetupDiGetHwProfileList

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