CM_Get_HW_Prof_Flags_ExW函式 （cfgmgr32.h）
[此函式已被取代，不應使用。]
語法
CMAPI CONFIGRET CM_Get_HW_Prof_Flags_ExW(
[in] DEVINSTID_W pDeviceID,
[in] ULONG ulHardwareProfile,
[out] PULONG pulValue,
[in] ULONG ulFlags,
[in, optional] HMACHINE hMachine
);
參數
[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
保留供內部使用。 必須設定為零。
[in, optional] hMachine
呼叫 CM_Connect_Machine 或 NULL所傳回的電腦句柄。 如果此參數設定為 NULL，CM_Get_HW_Prof_Flags_Ex 擷取本機電腦上的組態旗標。
傳回值
如果作業成功，CM_Get_HW_Prof_Flags 會傳回CR_SUCCESS。 否則，函式會傳回 Cfgmgr32.h中定義的其中一個CR_前置錯誤碼。
言論
若要擷取目前在遠端電腦上定義的硬體設定檔識別碼清單，請呼叫 SetupDiGetHwProfileListEx。
Windows 8 和 Windows Server 2012 和更新版本的作業系統已移除存取遠端電腦的功能，因此您無法在這些版本的 Windows 上執行時存取遠端電腦。
注意
cfgmgr32.h 標頭會將CM_Get_HW_Prof_Flags_Ex定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Microsoft Windows 2000 和更新版本的 Windows 中提供。 |
| 目標平臺 | 桌面 |
| 標頭 | cfgmgr32.h （包括 Cfgmgr32.h） |
| 連結庫 | Cfgmgr32.lib |