CM_Enumerate_EnumeratorsA函式 (cfgmgr32.h)

CM_Enumerate_Enumerators函式會藉由提供每個列舉值的名稱來列舉本機計算機的裝置列舉值。

語法

CMAPI CONFIGRET CM_Enumerate_EnumeratorsA(
  [in]      ULONG  ulEnumIndex,
  [out]     PSTR   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。

規格需求

另請參閱

CM_Enumerate_Enumerators_Ex