[New - Windows NT]
GetCurrentHwProfile功能检索有关本地计算机的当前硬件配置文件的信息。
BOOL GetCurrentHwProfile(
LPHW_PROFILE_INFO 【lpHwProfileInfo】 | //接收硬件配置文件信息 |
); |
参数
【lpHwProfileInfo】
指向HW_PROFILE_INFO结构的指针,其中函数返回有关当前硬件配置文件的信息。
返回值
如果函数成功,则返回值为非零值。
如果函数失败,返回值为零。要获取扩展错误信息,请调用GetLastError.
备注
GetCurrentHwProfile功能检索硬件配置文件的显示名称和全局唯一标识符(GUID)字符串。该函数还检索带有扩展坞的便携式计算机的报告对接状态。
系统为每个硬件配置文件生成一个GUID,并将其作为字符串存储在注册表中。您可以使用GetCurrentHwProfile检索GUID字符串,以用作您的应用程序在HKEY_CURRENT_USER中的配置设置键下的注册表子项。这使您能够存储每个硬件配置文件的每个用户的设置。例如,颜色控制面板应用程序可以使用子项来存储每个用户对不同硬件配置文件的颜色偏好设置,例如停靠和停靠状态的配置文件。使用此函数的应用程序可以在启动时检查当前的硬件配置文件,并相应地更新其设置。
Windows 95:当系统设备消息(如DBT_CONFIGCHANGED)指示硬件配置文件已更改时,应用程序还可以更新其设置。
例
#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);
} // main
也可以看看