CM_Enumerate_Enumerators_ExW函式 (cfgmgr32.h)

[從 Windows 8 和 Windows Server 2012 開始，此函式已被取代。 請改用 CM_Enumerate_Enumerators 。]

CM_Enumerate_Enumerators_Ex函式會藉由提供每個列舉值的名稱，列舉本機或遠端電腦的裝置列舉值。

語法

CMAPI CONFIGRET CM_Enumerate_Enumerators_ExW(
  [in]           ULONG    ulEnumIndex,
  [out]          PWSTR    Buffer,
  [in, out]      PULONG   pulLength,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

參數

[in] ulEnumIndex

呼叫端提供的索引到計算機的裝置列舉值清單中。 如需詳細資訊，請參閱下列一節。

[out] Buffer

要接收列舉值名稱的緩衝區位址。 此緩衝區應MAX_DEVICE_ID_LEN大小 (，或將 Buffer 設定為零，並在 puLength) 所參考的位置中取得實際名稱長度。

[in, out] pulLength

位置的呼叫端提供位址，以保存緩衝區大小。 呼叫端會提供 Buffer 所指向的緩衝區長度。 函式會將此值取代為列舉值名稱字串的實際大小。 如果呼叫端提供的緩衝區長度太小，函式會提供所需的緩衝區大小，並傳回CR_BUFFER_SMALL。

[in] ulFlags

未使用，必須是零。

[in, optional] hMachine

呼叫端提供的機器句柄，是從先前呼叫 CM_Connect_Machine取得。

傳回值

如果作業成功，函式會傳回CR_SUCCESS。 否則，它會傳回 Cfgmgr32.h 中定義的其中一個CR_前置錯誤碼。

備註

若要列舉本機或遠端計算機的裝置列舉值，請重複呼叫 CM_Enumerate_Enumerators_Ex ，從 ulEnumIndex 索引值為零開始，並在每次後續呼叫時遞增索引值，直到函式傳回CR_NO_SUCH_VALUE為止。

取得列舉值名稱之後，就可以將名稱當做 輸入來CM_Get_Device_ID_List。

存取遠端電腦的功能已在 Windows 8 和 Windows Server 2012 和更新版本的作業系統中移除，因此您無法在這些版本的 Windows 上執行時存取遠端電腦。

規格需求

另請參閱

CM_Enumerate_Enumerators