CM_Enumerate_EnumeratorsW函式 (cfgmgr32.h)
CM_Enumerate_Enumerators函式會藉由提供每個列舉值的名稱來列舉本機計算機的裝置列舉值。
語法
CMAPI CONFIGRET CM_Enumerate_EnumeratorsW(
[in] ULONG ulEnumIndex,
[out] PWSTR Buffer,
[in, out] PULONG pulLength,
[in] ULONG ulFlags
);
參數
[in] ulEnumIndex
呼叫端提供的索引會插入計算機的裝置列舉值清單中。 如需詳細資訊，請參閱下列一節。
[out] Buffer
要接收列舉值名稱之緩衝區的位址。 此緩衝區應MAX_DEVICE_ID_LEN大小 (，或將 Buffer 設定為零，並在 puLength 所參考的位置取得實際名稱長度) 。
[in, out] pulLength
呼叫端提供的位置位址，以保存緩衝區大小。 呼叫端會提供 Buffer 所指向的緩衝區長度。 函式會將此值取代為列舉值名稱字串的實際大小。 如果呼叫端提供的緩衝區長度太小，函式會提供所需的緩衝區大小，並傳回CR_BUFFER_SMALL。
[in] ulFlags
未使用，必須是零。
傳回值
如果作業成功，函式會傳回CR_SUCCESS。 否則，它會傳回 Cfgmgr32.h 中定義的其中一個CR_前置錯誤碼。
備註
若要列舉本機計算機的裝置列舉值，請重複呼叫 CM_Enumerate_Enumerators ，從 ulEnumIndex 索引值為零開始。 並隨著每個後續呼叫遞增索引值，直到函式傳回CR_NO_SUCH_VALUE為止。
取得列舉值名稱之後，即可將名稱當做輸入來 CM_Get_Device_ID_List。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 可在 Microsoft Windows 2000 和更新版本的 Windows 中使用。 |
| 目標平台 | 桌面 |
| 標頭 | cfgmgr32.h (包含 Cfgmgr32.h) |
| 程式庫 | Cfgmgr32.lib |