HW_PROFILE_INFO structure

Contains information about a hardware profile. The GetCurrentHwProfile function uses this structure to retrieve the current hardware profile for the local computer.

Syntax


typedef struct tagHW_PROFILE_INFO {
  DWORD dwDockInfo;
  TCHAR szHwProfileGuid[HW_PROFILE_GUIDLEN];
  TCHAR szHwProfileName[MAX_PROFILE_LEN];
} HW_PROFILE_INFO, *LPHW_PROFILE_INFO;

Members

dwDockInfo

The reported docking state of the computer. This member can be a combination of the following bit values.

ValueMeaning
DOCKINFO_DOCKED
0x2

The computer is docked.

DOCKINFO_UNDOCKED
0x1

The computer is undocked. This flag is always set for desktop systems that cannot be undocked.

DOCKINFO_USER_SUPPLIED
0x4

If this flag is set, GetCurrentHwProfile retrieved the current docking state from information provided by the user in the Hardware Profiles page of the System control panel application.

If there is no such value or the value is set to 0, this flag is set.

DOCKINFO_USER_DOCKED
0x5

The computer is docked, according to information provided by the user. This value is a combination of the DOCKINFO_USER_SUPPLIED and DOCKINFO_DOCKED flags.

DOCKINFO_USER_UNDOCKED
0x6

The computer is undocked, according to information provided by the user. This value is a combination of the DOCKINFO_USER_SUPPLIED and DOCKINFO_UNDOCKED flags.

 

szHwProfileGuid

The globally unique identifier (GUID) string for the current hardware profile. The string returned by GetCurrentHwProfile encloses the GUID in curly braces, {}; for example:

{12340001-4980-1920-6788-123456789012}

You can use this string as a registry subkey under your application's configuration settings key in HKEY_CURRENT_USER. This enables you to store settings for each hardware profile.

szHwProfileName

The display name for the current hardware profile.

Examples

For an example, see GetCurrentHwProfile.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Winbase.h (include Windows.h)

Unicode and ANSI names

HW_PROFILE_INFOW (Unicode) and HW_PROFILE_INFOA (ANSI)

See also

GetCurrentHwProfile

 

 

Community Additions

ADD
Show:
© 2014 Microsoft