структура HW_PROFILE_INFOA (winbase.h)

Статья
11/20/2024

Содержит сведения о профиле оборудования. Функция getCurrentHwProfile использует эту структуру для получения текущего профиля оборудования для локального компьютера.

Синтаксис

typedef struct tagHW_PROFILE_INFOA {
  DWORD dwDockInfo;
  CHAR  szHwProfileGuid[HW_PROFILE_GUIDLEN];
  CHAR  szHwProfileName[MAX_PROFILE_LEN];
} HW_PROFILE_INFOA, *LPHW_PROFILE_INFOA;

Члены

dwDockInfo

Сообщаемое состояние док-станции компьютера. Этот элемент может быть сочетанием следующих битовых значений.

Ценность	Значение
DOCKINFO_DOCKED 0x2	Компьютер закреплен.
DOCKINFO_UNDOCKED 0x1	Компьютер откреплен. Этот флаг всегда устанавливается для классических систем, которые не могут быть откреплены.
DOCKINFO_USER_SUPPLIED 0x4	Если этот флаг задан, GetCurrentHwProfile извлекли текущее состояние закрепления из сведений, предоставленных пользователем на странице профилей оборудования приложения панели управления System. Если такого значения нет или значение имеет значение 0, этот флаг устанавливается.
DOCKINFO_USER_DOCKED 0x5	Компьютер закреплен в соответствии с информацией, предоставленной пользователем. Это значение представляет собой сочетание флагов DOCKINFO_USER_SUPPLIED и DOCKINFO_DOCKED.
DOCKINFO_USER_UNDOCKED 0x6	Компьютер откреплен в соответствии с информацией, предоставленной пользователем. Это значение представляет собой сочетание флагов DOCKINFO_USER_SUPPLIED и DOCKINFO_UNDOCKED.

szHwProfileGuid[HW_PROFILE_GUIDLEN]

Строка глобально уникального идентификатора (GUID) для текущего профиля оборудования. Строка, возвращаемая GetCurrentHwProfile заключает GUID в фигурные скобки, {}; Например:

{12340001-4980-1920-6788-123456789012}

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

szHwProfileName[MAX_PROFILE_LEN]

Отображаемое имя текущего профиля оборудования.

Замечания

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
заголовка	winbase.h (включая Windows.h)

См. также

GetCurrentHwProfile

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