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