itAddressTranslation::get_Locations 方法 (tapi3if.h)
get_Locations 方法创建当前可用地址位置的集合。 此方法适用于自动化客户端应用程序,例如使用 Visual Basic 编写的客户端应用程序。 C 和 C++ 应用程序必须使用 EnumerateLocations 方法。
语法
HRESULT get_Locations(
[out] VARIANT *pVariant
);
参数
[out] pVariant
指向 VARIANT 的指针,其中包含 ITLocationInfo 接口指针的 ITCollection (location 对象) 。
返回值
此方法可以返回其中一个值。
值 | 含义 |
---|---|
|
方法成功。 |
|
pVariant 参数不是有效的指针。 |
|
内存不足,无法执行操作。 |
注解
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 |