itAddressTranslation::get_Locations 方法 (tapi3if.h)

get_Locations 方法创建当前可用地址位置的集合。 此方法适用于自动化客户端应用程序,例如使用 Visual Basic 编写的客户端应用程序。 C 和 C++ 应用程序必须使用 EnumerateLocations 方法。

语法

HRESULT get_Locations(
  [out] VARIANT *pVariant
);

参数

[out] pVariant

指向 VARIANT 的指针,其中包含 ITLocationInfo 接口指针的 ITCollection (location 对象) 。

返回值

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

含义
S_OK
方法成功。
E_POINTER
pVariant 参数不是有效的指针。
E_OUTOFMEMORY
内存不足,无法执行操作。

注解

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

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

要求

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

另请参阅

Address 对象

EnumerateLocations

ITAddressTranslation

ITCollection

ITLocationInfo