Функция GetCurrentHwProfileA (winbase.h)

Извлекает сведения о текущем профиле оборудования для локального компьютера.

Синтаксис

BOOL GetCurrentHwProfileA(
  [out] LPHW_PROFILE_INFOA lpHwProfileInfo
);

Параметры

[out] lpHwProfileInfo

Указатель на структуру HW_PROFILE_INFO , которая получает сведения о текущем профиле оборудования.

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

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

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Комментарии

Функция GetCurrentHwProfile извлекает отображаемое имя и строку глобально уникального идентификатора (GUID) для профиля оборудования. Функция также извлекает сообщаемое состояние стыковки для переносных компьютеров с док-станциями.

Система создает GUID для каждого профиля оборудования и сохраняет его в виде строки в реестре. GetCurrentHwProfile можно использовать для получения строки GUID, используемой в качестве подраздела реестра в разделе параметров конфигурации приложения в HKEY_CURRENT_USER. Это позволяет хранить параметры каждого пользователя для каждого профиля оборудования. Например, приложение панели управления "Цвета" может использовать подраздел для хранения настроек цвета каждого пользователя для различных профилей оборудования, таких как профили для закрепленных и отстыковых состояний. Приложения, использующие эту функцию, могут проверка текущий профиль оборудования при запуске и соответствующим образом обновить свои параметры.

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

Чтобы скомпилировать приложение, использующее эту функцию, определите макрос _WIN32_WINNT как 0x0400 или более поздней версии. Дополнительные сведения см. в разделе Использование заголовков Windows.

Примеры

#include <windows.h>
#include <stdio.h>
#include <tchar.h>

void main(void) 
{
   HW_PROFILE_INFO   HwProfInfo;
   if (!GetCurrentHwProfile(&HwProfInfo)) 
   {
      _tprintf(TEXT("GetCurrentHwProfile failed with error %lx\n"), 
                 GetLastError());
      return;
   }
   _tprintf(TEXT("DockInfo = %d\n"), HwProfInfo.dwDockInfo);
   _tprintf(TEXT("Profile Guid = %s\n"), HwProfInfo.szHwProfileGuid);
   _tprintf(TEXT("Friendly Name = %s\n"), HwProfInfo.szHwProfileName);
}

Требования

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

DBT_CONFIGCHANGED

HW_PROFILE_INFO

Функции сведений о системе