Метод ITAddressTranslation::get_Locations (tapi3if.h)
Метод get_Locations создает коллекцию доступных в настоящее время расположений адресов. Этот метод предоставляется для клиентских приложений службы автоматизации, например написанных на Visual Basic. Приложения C и C++ должны использовать метод EnumerateLocations .
Синтаксис
HRESULT get_Locations(
[out] VARIANT *pVariant
);
Параметры
[out] pVariant
Указатель на VARIANT , содержащий коллекцию ITCollection указателей интерфейса ITLocationInfo (объектов location).
Возвращаемое значение
Этот метод может возвращать одно из этих значений.
| Значение | Значение |
|---|---|
|
Метод успешно выполнен. |
|
Параметр pVariant не является допустимым указателем. |
|
Для выполнения операции недостаточно памяти. |
Комментарии
Метод get_Locations является com-оболочкой для функции TAPI 2.1 LineGetTranslateCaps и принимает сведения о расположении из структуры LINETRANSLATECAPS , возвращаемой этой функцией.
TAPI вызывает метод AddRef в интерфейсе ITLocationInfo , возвращенном ITAddressTranslation::get_Locations. Приложение должно вызывать Release в интерфейсе ITLocationInfo , чтобы освободить связанные с ним ресурсы.
Требования
| Целевая платформа | Windows |
| Header | tapi3if.h (включая Tapi3.h) |
| Библиотека | Uuid.lib |
| DLL | Tapi3.dll |