CM_Get_HW_Prof_Flags_ExW函式 (cfgmgr32.h)

發行項
02/23/2024

[此函式已被取代，不應使用。]

CM_Get_HW_Prof_Flags_Ex函式會擷取遠端電腦或本機計算機上裝置實例的硬體配置檔特定組態旗標。

語法

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會擷取本機電腦上的組態旗標。

注意從 Windows 8 和 Windows Server 2012 開始，不支援使用此函式來存取遠端電腦，因為已移除此功能。

傳回值

如果作業成功， 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

另請參閱

CM_Get_HW_Prof_Flags

SetupDiGetHwProfileFriendlyNameEx

SetupDiGetHwProfileListEx

共用方式為