通过

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)
Library Uuid.lib
DLL Tapi3.dll

另请参阅

ITCollection