Метод ITAgent::CreateSession (tapi3.h)

Статья
03/08/2023

Метод CreateSession создает новый сеанс агента для входной группы ACD и адреса.

Синтаксис

HRESULT CreateSession(
  [in]  ITACDGroup     *pACDGroup,
  [in]  ITAddress      *pAddress,
  [out] ITAgentSession **ppAgentSession
);

Параметры

[in] pACDGroup

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

[in] pAddress

Указатель на объект ITAddress, доступный для получения вызовов ACD.

[out] ppAgentSession

Указатель на интерфейс ITAgentSession для созданного объекта.

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

Этот метод может возвращать одно из этих значений.

Значение	Значение
S_OK	Метод успешно выполнен.
E_POINTER	Параметр ppAgentSession не является допустимым указателем.
E_UNEXPECTED	Не удалось открыть строку для целевого адреса.
E_INVALIDARG	Недопустимый аргумент pACDGroup или pAddress .
E_OUTOFMEMORY	Для выполнения операции недостаточно памяти.
TAPI_E_TIMEOUT	Операция завершилась сбоем, так как время ожидания библиотеки DLL TAPI 3 истекло. Интервал времени ожидания составляет две минуты.

TAPI вызывает метод AddRef в интерфейсе ITAgentSession , возвращенном МЕТОДом ITAgent::CreateSession. Приложение должно вызвать Release в интерфейсе ITAgentSession , чтобы освободить связанные с ним ресурсы.

Для открытия сеанса для некоторых телефонных сред требуется личный идентификационный номер. См . раздел CreateSessionWithPIN.