Função lineGetGroupListA (tapi.h)

Artigo
08/26/2023

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 variável 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 membro dwTotalSize dessa estrutura para indicar a quantidade de memória disponível para TAPI para retornar informações.

Nota 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 retornado

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.

Comentários

Observação

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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.