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