CM_Get_HW_Prof_FlagsW函式 （cfgmgr32.h）
[從 Windows 8 和 Windows Server 2012 開始，此函式已被取代，不應使用。]
CM_Get_HW_Prof_Flags 函式會擷取本機電腦上 裝置實例 特定組態旗標 硬體配置檔。
語法
CMAPI CONFIGRET CM_Get_HW_Prof_FlagsW(
[in] DEVINSTID_W pDeviceID,
[in] ULONG ulHardwareProfile,
[out] PULONG pulValue,
[in] ULONG ulFlags
);
參數
[in] pDeviceID
NULL 終止字串的指標，其中包含要擷取硬體配置檔特定組態旗標之裝置的 裝置實例標識碼。
[in] ulHardwareProfile
ULONG 類型的變數，指定要擷取組態旗標的硬體配置檔識別碼。 如果此參數為零，此函式會擷取目前硬體配置檔的組態旗標。
[out] pulValue
ULONG 類型之呼叫端提供的變數指標，該變數會接收 Regstr.h中定義的下列組態旗標的零或位 OR：
CSCONFIGFLAG_BITS
其他CSCONFIGFLAG_Xxx旗標的位 OR。
CSCONFIGFLAG_DISABLE
在指定的硬體配置檔中，裝置實例已停用。
CSCONFIGFLAG_DO_NOT_CREATE
硬體配置檔不支援指定的裝置實例。
CSCONFIGFLAG_DO_NOT_START
裝置無法在指定的硬體配置檔中啟動。
[in] ulFlags
保留供內部使用。 必須設定為零。
傳回值
如果作業成功，CM_Get_HW_Prof_Flags 會傳回CR_SUCCESS。 否則，函式會傳回 Cfgmgr32.h中定義的其中一個 CR_Xxx 錯誤碼。
言論
若要擷取目前在本機電腦上定義的硬體配置檔識別碼清單，請呼叫 SetupDiGetHwProfileList。
若要擷取遠端電腦上裝置實例的組態旗標，請呼叫 CM_Get_HW_Prof_Flags_Ex。
注意
cfgmgr32.h 標頭會將 CM_Get_HW_Prof_Flags定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Microsoft Windows 2000 和更新版本的 Windows 中提供。 |
| 目標平臺 | 桌面 |
| 標頭 | cfgmgr32.h （包括 Cfgmgr32.h） |
| 連結庫 | Cfgmgr32.lib |