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 |