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


Метод ITAgent::CreateSessionWithPIN (tapi3cc.h)

Метод CreateSessionWithPIN создает новый сеанс агента для входной группы ACD и адреса с личным идентификационном номером (ПИН-кодом).

Синтаксис

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

Параметры

[in] pACDGroup

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

[in] pAddress

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

[in] pPIN

Указатель на представление BSTR ПИН-кода агента.

[out] ppAgentSession

Указатель на созданный сеанс.

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

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

Значение Значение
S_OK
Метод успешно выполнен.
TAPI_E_CALLCENTER_NO_AGENT_ID
Агент не создан с помощью CreateAgentWithID.
TAPI_E_TIMEOUT
Операция завершилась сбоем, так как время ожидания библиотеки DLL TAPI 3 истекло. Интервал времени ожидания составляет две минуты.
E_INVALIDARG
Значение pPIN равно NULL.
E_POINTER
Параметр pPIN или ppAgentSession не является допустимым указателем.
E_OUTOFMEMORY
Для выполнения операции недостаточно памяти.

Комментарии

Приложение должно использовать SysAllocString для выделения памяти для pPIN и SysFreeString , чтобы освободить память, когда переменная больше не нужна.

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

Требования

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

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

ITAgent

ITAgent::CreateSession

ITAgentSession