Метод ITAgent::CreateSessionWithPIN (tapi3.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 | tapi3.h (включая Tapi3.h) |
Библиотека | Uuid.lib |
DLL | Tapi3.dll |