Функция lineCreateAgentSessionA (tapi.h)
Функция lineCreateAgentSession создает новый объект AgentSession. Он создает сообщение LINE_PROXYREQUEST , которое будет отправлено в зарегистрированный обработчик функции прокси-сервера, ссылающееся на структуру LINEPROXYREQUEST типа LINEPROXYREQUEST_CREATEAGENTSESSION.
Синтаксис
LONG lineCreateAgentSessionA(
HLINE hLine,
HAGENT hAgent,
LPCSTR lpszAgentPIN,
DWORD dwWorkingAddressID,
LPGUID lpGroupID,
LPHAGENTSESSION lphAgentSession
);
Параметры
hLine
Дескриптор на линейное устройство.
hAgent
Идентификатор агента, для которого создается сеанс.
lpszAgentPIN
Указатель на строку Юникода с пустым завершением, содержащую ПИН-код или пароль агента. Используется при работе с устаревшими системами ACD, для которых требуется отдельный ПИН-код для каждого созданного сеанса (или группы, вошедшие в систему). В системе ACD, которая использует имя входа пользователя операционной системы для проверки подлинности, lpszAgentPIN имеет значение NULL.
dwWorkingAddressID
Идентификатор адреса, по которому агент будет принимать вызовы для этого сеанса.
lpGroupID
Указатель на GUID, который идентифицирует группу, для которой создается сеанс.
lphAgentSession
Обработка созданного сеанса агента, возвращаемого прокси-сервером ACD. Создание и поддержание уникальности этих идентификаторов лежит на прокси-приложении обработчика агента.
Возвращаемое значение
Возвращает идентификатор запроса, если начинается асинхронная операция; В противном случае функция возвращает одно из следующих значений ошибки:
LINEERR_INVALLINEHANDLE, LINEERR_INVALPARAM, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL LINEERR_UNINITIALIZED.
Комментарии
Примечание
Заголовок tapi.h определяет lineCreateAgentSession в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
Требование | Значение |
---|---|
Целевая платформа | Windows |
Header | tapi.h |
Библиотека | Tapi32.lib |
DLL | Tapi32.dll |