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只傳回裝置設定類別。

規格需求

另請參閱

CM_Enumerate_Classes_Ex