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

Метод 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.

Требования

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

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

IEnumAgentSession

ITACDGroup

ITAddress

ITAgent

ITAgent::CreateSessionWithPIN

ITAgentSession