Função lineAccept (tapi.h)

Artigo
03/02/2024

A função lineAccept aceita a chamada oferecida especificada. Opcionalmente, ele pode enviar as informações de usuário-usuário especificadas para a parte de chamada.

Sintaxe

LONG lineAccept(
  HCALL  hCall,
  LPCSTR lpsUserUserInfo,
  DWORD  dwSize
);

Parâmetros

hCall

Manipule para a chamada a ser aceita. O aplicativo deve ser um proprietário da chamada. O estado de chamada de hCall deve estar oferecendo.

lpsUserUserInfo

Ponteiro para uma cadeia de caracteres terminada em nulo que contém informações de usuário-usuário a serem enviadas para a parte remota como parte da aceitação da chamada. Esse ponteiro poderá ser deixado NULL se nenhuma informação de usuário deve ser enviada. As informações do usuário são enviadas somente se houver suporte da rede subjacente (consulte LINEDEVCAPS). O membro discriminador de protocolo para as informações do usuário-usuário, se necessário, deve aparecer como o primeiro byte do buffer apontado por lpsUserUserInfo e deve ser contabilizado no dwSize.

dwSize

Tamanho das informações de usuário-usuário em lpsUserUserInfo (incluindo o terminador nulo ), em bytes. Se lpsUserUserInfo for NULL, nenhuma informação de usuário será enviada para a parte de chamada e dwSize será ignorada.

Retornar valor

Retorna um identificador de solicitação positivo se a função for concluída de forma assíncrona ou um número de erro negativo se ocorrer um erro. O parâmetro dwParam2 da mensagem de LINE_REPLY correspondente será zero se a função for bem-sucedida ou se for um número de erro negativo se ocorrer um erro. Os valores retornados possíveis são:

LINEERR_INVALCALLHANDLE, LINEERR_INVALCALLSTATE, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_NOTOWNER, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED, LINEERR_USERUSERINFOTOOBIG.

Comentários

A função lineAccept é usada em ambientes de telefonia, como ISDN (Rede Digital de Serviços Integrados), que permitem que os alertas associados às chamadas de entrada sejam separados da oferta inicial da chamada. Quando uma chamada chega, ela é oferecida pela primeira vez. Por algum tempo, o aplicativo pode ter a opção de rejeitar a chamada usando lineDrop, redirecionar a chamada para outra estação usando lineRedirect, atender a chamada usando lineAnswer ou aceitar a chamada usando lineAccept. Depois que uma chamada é aceita com êxito por um aplicativo, o alerta começa no dispositivo chamado e de chamada e o estado da chamada normalmente faz a transição para aceita.

O alerta é relatado ao aplicativo pela mensagem LINE_LINEDEVSTATE com a indicação de toque .

A função lineAccept também pode ter suporte de provedores de serviços não ISDN. A transição de estado de chamada para aceita pode ser usada por outros aplicativos como uma indicação de que outro aplicativo reivindicou a responsabilidade pela chamada e apresentou a chamada ao usuário.

O aplicativo tem a opção de enviar informações de usuário-usuário no momento da aceitação. Mesmo que as informações do usuário-usuário sejam enviadas, não há nenhuma garantia de que a rede fornecerá essas informações à parte de chamada. Um aplicativo deve consultar os recursos de dispositivo de uma linha para determinar se a aceitação de chamada está disponível.