itAddressTranslation::EnumerateLocations 方法 (tapi3if.h)

EnumerateLocations 方法枚举当前可用的地址位置。 此方法是为 C 和 C++ 应用程序提供的。 自动化客户端应用程序(如用 Visual Basic 编写的客户端应用程序)必须使用 get_Locations 方法。

语法

HRESULT EnumerateLocations(
  [out] IEnumLocation **ppEnumLocation
);

参数

[out] ppEnumLocation

指向创建的 IEnumLocation 对象的指针。

返回值

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

含义
S_OK
方法成功。
E_POINTER
ppEnumLocations 参数不是有效的指针。
E_OUTOFMEMORY
内存不足,无法创建对象。

注解

EnumerateLocations 方法是 TAPI 2.1 LineGetTranslateCaps 函数的 COM 包装器,并从该函数返回的 LINETRANSLATECAPS 结构中获取位置信息。

TAPI 在 ITAddressTranslation::EnumerateLocations 返回的 IEnumLocation 接口上调用 AddRef 方法。 应用程序必须在 IEnumLocation 接口上调用 Release,以释放与其关联的资源。

要求

要求
目标平台 Windows
标头 tapi3if.h (包括 Tapi3.h)
Library Uuid.lib
DLL Tapi3.dll

另请参阅

Address 对象

IEnumLocation

ITAddressTranslation