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

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

  • Статья

Функция lineCreateAgent создает новый объект Агента. Он создает сообщение LINE_PROXYREQUEST для отправки в зарегистрированный обработчик функции прокси-сервера, ссылающееся на структуру LINEPROXYREQUEST типа LINEPROXYREQUEST_CREATEAGENT.

Синтаксис

LONG lineCreateAgentA(
  HLINE    hLine,
  LPCSTR   lpszAgentID,
  LPCSTR   lpszAgentPIN,
  LPHAGENT lphAgent
);

Параметры

hLine

Дескриптор для устройства линии.

lpszAgentID

Указатель на строку Юникода, завершающуюся null, которая содержит идентификатор агента. Используется при работе с устаревшими системами ACD. В системе ACD, которая использует имя входа пользователя операционной системы для проверки подлинности, lpszAgentID имеет значение NULL.

lpszAgentPIN

Указатель на строку Юникода, завершающуюся null, которая содержит ПИН-код или пароль агента. Используется при работе с устаревшими системами ACD. В системе ACD, которая использует имя входа пользователя операционной системы для проверки подлинности, lpszAgentPIN имеет значение NULL.

lphAgent

Дескриптор созданного агента, возвращаемый прокси-сервером ACD. Создание и сохранение уникальности этого идентификатора лежит на прокси-приложении обработчика агента.

Возвращаемое значение

Возвращает идентификатор запроса, если начинается асинхронная операция; В противном случае функция возвращает одно из следующих значений ошибки:

LINEERR_INVALLINEHANDLE, LINEERR_INVALPARAM, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL LINEERR_UNINITIALIZED.

Комментарии

Примечание

Заголовок tapi.h определяет lineCreateAgent в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Целевая платформа Windows
Header tapi.h
Библиотека Tapi32.lib
DLL Tapi32.dll

См. также раздел

LINEPROXYREQUEST

LINE_PROXYREQUEST