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

Статья
11/20/2024

Функция lineGetQueueList возвращает список очередей, связанных с определенной группой ACD. Он создает сообщение LINE_PROXYREQUEST для отправки в зарегистрированный обработчик функции прокси-сервера, ссылаясь на структуру LINEPROXYREQUEST типа LINEPROXYREQUEST_GETQUEUELIST.

Синтаксис

LONG lineGetQueueListA(
  HLINE           hLine,
  LPGUID          lpGroupID,
  LPLINEQUEUELIST lpQueueList
);

Параметры

hLine

Дескриптор устройства строки.

lpGroupID

Указатель на GUID, определяющий группу, для которой запрашивается список очередей.

lpQueueList

Указатель на изменяемую структуру типа LINEQUEUELIST. После успешного завершения запроса эта структура заполняется списком очередей. Перед вызовом lineGetQueueListприложение должно задать dwTotalSize элемент этой структуры, чтобы указать объем памяти, доступной TAPI для возврата сведений.

Примечание Если параметры размера в структуре неверны, существует вероятность того, что данные могут быть перезаписаны. Дополнительные сведения о настройке размеров структуры см. в разделе выделение памяти.

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

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

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

Замечания

Заметка

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