Метод 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
Указатель на созданный сеанс.
Возвращаемое значение
Этот метод может возвращать одно из этих значений.
Значение | Значение |
---|---|
|
Метод успешно выполнен. |
|
Агент не создан с помощью CreateAgentWithID. |
|
Операция завершилась сбоем, так как время ожидания библиотеки DLL TAPI 3 истекло. Интервал времени ожидания составляет две минуты. |
|
Значение pPIN равно NULL. |
|
Параметр pPIN или ppAgentSession не является допустимым указателем. |
|
Для выполнения операции недостаточно памяти. |
Комментарии
Приложение должно использовать SysAllocString для выделения памяти для pPIN и SysFreeString , чтобы освободить память, когда переменная больше не нужна.
TAPI вызывает метод AddRef в интерфейсе ITAgentSession , возвращаемом ITAgent::CreateSessionWithPIN. Приложение должно вызвать Release в интерфейсе ITAgentSession , чтобы освободить связанные с ним ресурсы.
Требования
Требование | Значение |
---|---|
Целевая платформа | Windows |
Header | tapi3cc.h (включая Tapi3.h) |
Библиотека | Uuid.lib |
DLL | Tapi3.dll |