通过

winbase.h) (HW_PROFILE_INFOW 结构

  • 项目

包含有关硬件配置文件的信息。 GetCurrentHwProfile 函数使用此结构检索本地计算机的当前硬件配置文件。

语法

typedef struct tagHW_PROFILE_INFOW {
  DWORD dwDockInfo;
  WCHAR szHwProfileGuid[HW_PROFILE_GUIDLEN];
  WCHAR szHwProfileName[MAX_PROFILE_LEN];
} HW_PROFILE_INFOW, *LPHW_PROFILE_INFOW;

成员

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