Функция lineCreateAgentSessionA (tapi.h)

Статья
03/05/2024

Функция 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 или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.