共用方式為

ITCollection：：get__NewEnum 方法 (tapi3if.h)

  • 發行項

get__NewEnum方法會取得集合的列舉值。

語法

HRESULT get__NewEnum(
  [out] IUnknown **ppNewEnum
);

參數

[out] ppNewEnum

集合之列舉值物件上 IUnknown 介面的指標。

在傳回的IUnknown介面上呼叫QueryInterface方法，以取得集合上IEnumVARIANT列舉介面的指標。 IEnumVARIANT 提供許多方法，可讓您用來逐一查看集合。

如需詳細資訊，請參閱接下來的＜備註＞一節。

傳回值

這個方法可以傳回其中一個值。

傳回碼 描述
S_OK
 方法成功。
E_OUTOFMEMORY
 記憶體不足，無法執行作業。

備註

每個 TAPI 3 介面，包含傳回集合的方法也包含方法，該方法會傳回 TAPI 3 列舉值介面的指標。 如果您是以 C/C++ 進行程式設計，直接呼叫集合的列舉值方法可以更輕鬆地取得列舉值物件，而不是呼叫 ITCollection：：get__NewEnum 方法。 例如， ITTAPI：：EnumerateAddresses 方法會傳回 IEnumAddress 介面的指標。 IEnumAddress 提供 Address 物件的列舉方法。

如果您是在 Visual Basic 中進行程式設計，則不需要呼叫這個方法來列舉集合。 這是因為您可以使用 For... 隱含叫用方法的功能 每個。。。in...下。。。 構建。

需求

   
目標平台 Windows
標頭 tapi3if.h (包括 Tapi3.h)
程式庫 Uuid.lib
Dll Tapi3.dll

另請參閱

ITCollection