функция CM_Get_HW_Prof_FlagsA (cfgmgr32.h)
[Начиная с 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 (включая Cfgmgr32.h) |
| Библиотека | Cfgmgr32.lib |