Função lineSendUserUserInfo (tapi.h)

Artigo
08/26/2023

A função lineSendUserUserInfo envia informações de usuário-usuário para a parte remota na chamada especificada.

Sintaxe

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

Parâmetros

hCall

Manipule para a chamada na qual enviar informações de usuário-usuário. O aplicativo deve ser um proprietário da chamada. O estado de chamada de hCall deve ser conectado, oferecendo, aceito ou ringback.

lpsUserUserInfo

Ponteiro para uma cadeia de caracteres que contém informações de usuário-usuário a serem enviadas para a parte remota. As informações do usuário só serão enviadas se houver suporte para a rede subjacente (consulte LINEDEVCAPS). O campo discriminatório de protocolo para as informações de 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, em bytes.

Valor retornado

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 possíveis valores retornados são:

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

Comentários

Essa função pode ser usada para enviar informações de usuário-usuário a qualquer momento durante uma chamada conectada. Se o tamanho das informações especificadas a serem enviadas for maior do que o que pode caber em uma única mensagem de rede (como no ISDN), o provedor de serviços será responsável por dividir as informações em uma sequência de mensagens de rede encadeadas (usando "mais dados").

As informações do usuário também podem ser enviadas como parte da aceitação de chamadas, da rejeição de chamadas e do redirecionamento de chamadas e ao fazer chamadas. As informações do usuário também podem ser recebidas. As informações recebidas estão disponíveis por meio do registro de informações de chamada da chamada. Sempre que as informações do usuário chegam após a oferta de chamada ou antes da desconexão de chamadas, uma mensagem LINE_CALLINFO com um parâmetro UserUserInfo notifica o aplicativo de que as informações do usuário no registro de informações de chamada foram alteradas. Se várias mensagens de rede forem encadeadas, as informações serão montadas pelo provedor de serviços e uma única mensagem será enviada ao aplicativo.

Essa função pode enviar dados sobre o fio em forma não criptografada; portanto, alguém escutando na rede pode ser capaz de ler os dados. O risco de segurança de enviar os dados em texto claro deve ser considerado antes de usar esse método.