通过

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定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows 2000 Professional [仅限桌面应用]
支持的最低服务器 Windows 2000 Server [仅限桌面应用]
标头 winbase.h （包括 Windows.h）

另请参阅

GetCurrentHwProfile