Поделиться через

Метод 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 является com-оболочкой для функции TAPI 2.1 LineGetTranslateCaps и принимает сведения о расположении из структуры LINETRANSLATECAPS , возвращаемой этой функцией.

TAPI вызывает метод AddRef в интерфейсе IEnumLocation , возвращенном ITAddressTranslation::EnumerateLocations. Приложение должно вызвать Release в интерфейсе IEnumLocation , чтобы освободить связанные с ним ресурсы.

Требования

Требование Значение
Целевая платформа Windows
Header tapi3if.h (включая Tapi3.h)
Библиотека Uuid.lib
DLL Tapi3.dll

См. также раздел

Объект Address

IEnumLocation

ITAddressTranslation