itTAPI：：EnumerateAddresses 方法 (tapi3if.h)

项目
03/02/2024

EnumerateAddresses 方法枚举当前可用的地址。为 C 和 C++ 应用程序提供。自动化客户端应用程序（如用 Visual Basic 编写的客户端应用程序）必须使用 get_Addresses 方法。

语法

HRESULT EnumerateAddresses(
  [out] IEnumAddress **ppEnumAddress
);

参数

[out] ppEnumAddress

指向 IEnumAddress 接口的指针。

返回值

此方法可以返回其中一个值。

值	含义
S_OK	方法成功。
E_POINTER	ppEnumAddress 参数不是有效的指针。
E_INVALIDARG	TAPI 对象尚未初始化。
E_OUTOFMEMORY	内存不足，无法执行操作。

注解

应用程序通常使用此枚举来检查每个地址的功能，并确定哪些功能可用于当前目的。

如果未找到预期的地址，这可能表示尚未安装相应的服务提供程序或未正常工作。

TAPI 在 ITTAPI：：EnumerateAddresses 返回的 IEnumAddress 接口上调用 Addref 方法。应用程序必须在 IEnumAddress 接口上调用 Release 方法，以释放与其关联的资源。

如果在 TAPI 会话期间创建或删除了地址，将通过 ITTAPIEventNotification 接口通知应用程序。如果已创建地址（例如通过安装即插即用设备），则 ITTAPIEventNotification：：Event 将返回TAPIOBJECT_EVENT枚举的TE_ADDRESSCREATE成员。如果删除地址， ITTAPIEventNotification：：Event 将返回 TE_ADDRESSREMOVE。在这些事件之后调用 EnumerateAddresses 将反映当前地址。