Compartilhar via


Função lineGetQueueListA (tapi.h)

A função lineGetQueueList retorna uma lista de filas associadas a um grupo ACD específico. Ele gera uma mensagem de LINE_PROXYREQUEST a ser enviada a um manipulador de função proxy registrado, fazendo referência a uma estrutura LINEPROXYREQUEST do tipo LINEPROXYREQUEST_GETQUEUELIST.

Sintaxe

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

Parâmetros

hLine

Manipule para o dispositivo de linha.

lpGroupID

Ponteiro para GUID que identifica o grupo para o qual a lista de filas é solicitada.

lpQueueList

Ponteiro para uma estrutura de tamanho variavelmente do tipo LINEQUEUELIST . Após a conclusão bem-sucedida da solicitação, essa estrutura é preenchida com uma lista de filas. Antes de chamar lineGetQueueList, o aplicativo deve definir o dwTotalSize membro dessa estrutura para indicar a quantidade de memória disponível para TAPI para retornar informações.

Observação Se os parâmetros de tamanho na estrutura não estiverem corretos, há a possibilidade de que os dados possam ser substituídos. Para obter mais informações sobre como definir tamanhos de estrutura, consulte o tópico alocação de memória.
 

Valor de retorno

Retorna um identificador de solicitação se a operação assíncrona for iniciada; caso contrário, a função retornará um dos seguintes valores de erro:

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

Observações

Nota

O cabeçalho tapi.h define lineGetQueueList como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito Valor
da Plataforma de Destino Windows
cabeçalho tapi.h
biblioteca Tapi32.lib
de DLL Tapi32.dll

Consulte também

sobre controles de call center

LINEPROXYREQUEST

LINEQUEUELIST

LINE_PROXYREQUEST