Função lineSetAgentState (tapi.h)

A função lineSetAgentState define o estado do agente associado a um endereço específico.

Sintaxe

LONG lineSetAgentState(
  HLINE hLine,
  DWORD dwAddressID,
  DWORD dwAgentState,
  DWORD dwNextAgentState
);

Parâmetros

hLine

Identificador para o dispositivo de linha.

dwAddressID

Identificador do endereço para o qual as informações do agente devem ser alteradas. Um identificador de endereço está permanentemente associado a um endereço; o identificador permanece constante entre as atualizações do sistema operacional.

dwAgentState

Novo estado do agente. Deve ser uma das constantes LINEAGENTSTATE_ ou zero para deixar o estado do agente inalterado e modificar apenas o próximo estado.

dwNextAgentState

O estado do agente que deve ser definido automaticamente quando a chamada atual no endereço ficar ociosa. Por exemplo, se souber que o trabalho após a chamada deve ser executado, esse campo pode ser definido como LINEAGENTSTATE_WORKAFTERCALL para que uma nova chamada não seja atribuída ao agente após a chamada atual. Deve ser uma das constantes LINEAGENTSTATE_ ou zero para usar o próximo estado padrão configurado para o agente.

Retornar valor

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

LINEERR_INVALADDRESSID, LINEERR_INVALADDRESSSTATE, LINEERR_INVALAGENTSTATE, LINEERR_INVALLINEHANDLE, LINEERR_INVALPARAM, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL LINEERR_UNINITIALIZED.

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	tapi.h
Biblioteca	Tapi32.lib
DLL	Tapi32.dll

Confira também

Funções de serviço de linha suplementar

Visão geral da referência do TAPI 2.2