Função lineGetAgentActivityListW (tapi.h)

A função lineGetAgentActivityList obtém as identidades das atividades que o aplicativo pode selecionar usando lineSetAgentActivity para indicar qual função o agente está realmente executando no momento.

Sintaxe

LONG lineGetAgentActivityListW(
  HLINE                   hLine,
  DWORD                   dwAddressID,
  LPLINEAGENTACTIVITYLIST lpAgentActivityList
);

Parâmetros

hLine

Manipule para o dispositivo de linha aberta.

dwAddressID

Endereço no dispositivo de linha aberta cujo status do agente deve ser consultado. Um identificador de endereço está permanentemente associado a um endereço; o identificador permanece constante em atualizações do sistema operacional.

lpAgentActivityList

Ponteiro para uma estrutura de tamanho variavelmente do tipo LINEAGENTACTIVITYLIST . Após a conclusão bem-sucedida da solicitação, essa estrutura é preenchida com uma lista dos códigos de atividade do agente que podem ser selecionados usando lineSetAgentActivity. Antes de chamar lineGetAgentActivityList, o aplicativo deve definir o dwTotalSize membro dessa estrutura para indicar a quantidade de memória disponível para TAPI para retornar informações.

Valor de retorno

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

LINEERR_INVALADDRESSID, LINEERR_OPERATIONFAILED, LINEERR_INVALAGENTID, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

Observações

Nota

O cabeçalho tapi.h define lineGetAgentActivityList 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. 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

LINEAGENTACTIVITYLIST

Funções de serviço de linha suplementar

visão geral de referência do TAPI 2.2

lineSetAgentActivity