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

Статья
11/20/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

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

Требования

Требование	Ценность
целевая платформа	Виндоус
заголовка	tapi.h
библиотеки	Tapi32.lib
DLL	Tapi32.dll

См. также

о элементах управления Центра вызовов

LINEPROXYREQUEST

LINE_PROXYREQUEST

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