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

  • Статья

Содержит сведения о профиле оборудования. Функция 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 извлекает текущее состояние закрепления из сведений, предоставленных пользователем на странице Профили оборудования приложения панели управления системами .

Если такого значения нет или задано значение 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 или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Верхняя часть winbase.h (включая Windows.h)

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

GetCurrentHwProfile