Função lineGetGroupListA (tapi.h)

A função lineGetGroupList retorna uma lista de grupos ACD disponíveis no sistema ACD. Ele gera uma mensagem LINE_PROXYREQUEST a ser enviada a um manipulador de função proxy registrado, fazendo referência a uma estrutura LINEPROXYREQUEST do tipo LINEPROXYREQUEST_GETGROUPLIST.

Sintaxe

LONG lineGetGroupListA(
  HLINE                hLine,
  LPLINEAGENTGROUPLIST lpGroupList
);

Parâmetros

hLine

Manipule para o dispositivo de linha.

lpGroupList

Ponteiro para uma estrutura de tamanho variavelmente do tipo LINEAGENTGROUPLIST . Após a conclusão bem-sucedida da solicitação, essa estrutura é preenchida com uma lista dos grupos ACD disponíveis. Antes de chamar a função lineGetGroupList, 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 lineGetGroupList 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

LINEAGENTGROUPLIST

LINEPROXYREQUEST

LINE_PROXYREQUEST