CM_Enumerate_Classes函式 (cfgmgr32.h)
CM_Enumerate_Classes 函式 在重複呼叫時,藉由提供每個類別的 GUID 來列舉本機電腦的已安裝 裝置類別 。
語法
CMAPI CONFIGRET CM_Enumerate_Classes(
[in] ULONG ulClassIndex,
[out] LPGUID ClassGuid,
[in] ULONG ulFlags
);
參數
[in] ulClassIndex
呼叫端提供的索引到計算機的裝置類別清單中。 如需詳細資訊,請參閱備註一節。
[out] ClassGuid
呼叫端提供的 GUID 結構地址, (Microsoft Windows SDK) 中所述,以接收裝置類別的 GUID。
[in] ulFlags
從 Windows 8 開始,呼叫端可以指定下列旗標:
CM_ENUMERATE_CLASSES_INSTALLER
列舉裝置安裝類別。
CM_ENUMERATE_CLASSES_INTERFACE
列舉裝置介面類別。
否則,應設定為零。
傳回值
如果作業成功,函式會傳回CR_SUCCESS。 否則,它會傳回 Cfgmgr32.h 中定義的其中一個CR_前置錯誤碼。
備註
若要列舉本機計算機的裝置類別,請重複呼叫 CM_Enumerate_Classes ,從 ulClassIndex 值為零開始,並在每次後續呼叫時遞增索引值,直到函式傳回CR_NO_SUCH_VALUE為止。 某些索引值可能代表包含無效類別數據的清單專案,在此情況下,函式會傳回CR_INVALID_DATA。 您可以忽略這個傳回值。
從此函式取得的類別 GUID 可用來做為 裝置安裝函式的輸入。
從 Windows 8 和更新版本的操作系統開始,呼叫端可以使用ulFlags成員來指定CM_Enumerate_Classes應傳回的裝置類別。 在 Windows 8 之前,CM_Enumerate_Classes只傳回裝置設定類別。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 可在 Microsoft Windows 2000 和更新版本的 Windows 中使用。 |
目標平台 | 桌面 |
標頭 | cfgmgr32.h (包含 Cfgmgr32.h) |
程式庫 | Cfgmgr32.lib |
Dll | Cfgmgr32.dll |