Метод ITPhone::get_Terminals (tapi3if.h)
Метод get_Terminals извлекает коллекцию терминалов, связанных с телефоном. Приложению не нужно вызывать ITPhone::Open перед выполнением этого метода.
Синтаксис
HRESULT get_Terminals(
[in] ITAddress *pAddress,
[out] VARIANT *pTerminals
);
Параметры
[in] pAddress
Указатель на интерфейс ITAddress .
[out] pTerminals
Указатель на VARIANT , содержащий коллекцию ITCollection указателей интерфейса ITTerminal .
Возвращаемое значение
Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
Если с телефоном не связаны терминалы, этот метод создает пустую коллекцию и возвращает S_OK.
Приложению не нужно вызывать метод ITPhone::Open перед вызовом get_Terminals. Это связано с тем, что реализация объекта phone может открывать телефон и вызывать phoneGetID во время инициализации TAPI или при появлении нового объекта телефона.
TAPI вызывает метод AddRef в интерфейсе ITAddress , возвращенном ITPhone::get_Terminals. Приложение должно вызвать Release в интерфейсе ITAddress , чтобы освободить связанные с ним ресурсы.
Требования
| Целевая платформа | Windows |
| Header | tapi3if.h (включая Tapi3.h) |
| Библиотека | Uuid.lib |
| DLL | Tapi3.dll |