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

Метод ITPhone::EnumerateTerminals (tapi3if.h)

  • Статья

Метод EnumerateTerminals извлекает перечисление терминалов, связанных с телефоном. Приложению не нужно вызывать ITPhone::Open перед выполнением этого метода.

Синтаксис

HRESULT EnumerateTerminals(
  [in]  ITAddress     *pAddress,
  [out] IEnumTerminal **ppEnumTerminal
);

Параметры

[in] pAddress

Указатель на интерфейс ITAddress .

[out] ppEnumTerminal

Указатель на интерфейс IEnumTerminal , перечисляющий терминалы.

Возвращаемое значение

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Если с телефоном не связаны терминалы, этот метод создает пустое перечисление и возвращает S_OK.

Хотя для функции phoneGetID требуется дескриптор открытого телефонного устройства, приложению не нужно вызывать метод ITPhone::Open перед вызовом EnumerateTerminals. Это связано с тем, что реализация объекта phone может открывать телефон и вызывать phoneGetID во время инициализации TAPI или при появлении нового объекта телефона.

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

Требования

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

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

IEnumTerminal

ITAddress

ITPhone