共用方式為

HW_PROFILE_INFOW結構 （winbase.h）

  • 發行項

包含硬體配置文件的相關信息。 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