itAddressTranslation::EnumerateLocations 方法 (tapi3if.h)
EnumerateLocations 方法枚举当前可用的地址位置。 此方法是为 C 和 C++ 应用程序提供的。 自动化客户端应用程序(如用 Visual Basic 编写的客户端应用程序)必须使用 get_Locations 方法。
语法
HRESULT EnumerateLocations(
[out] IEnumLocation **ppEnumLocation
);
参数
[out] ppEnumLocation
指向创建的 IEnumLocation 对象的指针。
返回值
此方法可以返回其中一个值。
值 | 含义 |
---|---|
|
方法成功。 |
|
ppEnumLocations 参数不是有效的指针。 |
|
内存不足,无法创建对象。 |
注解
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 |