função TSPI_lineSendUserUserInfo (tspi.h)

Artigo
08/26/2023

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

Sintaxe

LONG TSPIAPI TSPI_lineSendUserUserInfo(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  LPCSTR        lpsUserUserInfo,
  DWORD         dwSize
);

Parâmetros

dwRequestID

O identificador da solicitação assíncrona.

hdCall

O identificador para a chamada na qual enviar informações de usuário-usuário. O estado de chamada do hdCall pode ser conectado, oferecendo, aceito ou ringback.

lpsUserUserInfo

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo 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).

dwSize

O tamanho, em bytes, incluindo o terminador nulo , das informações de usuário-usuário em lpsUserUserInfo.

Valor retornado

Retorna dwRequestID ou um número de erro se ocorrer um erro. O parâmetro real lResult do ASYNC_COMPLETION correspondente será zero se a função for bem-sucedida ou um número de erro se ocorrer um erro. Os possíveis valores retornados são os seguintes:

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_USERUSERINFOTOOBIG, LINEERR_OPERATIONUNAVAIL.

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 de aceitar chamadas, rejeitar chamadas, redirecionar chamadas e ao fazer chamadas. As informações do usuário também podem ser recebidas. As informações recebidas são relatadas na estrutura LINECALLINFO 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 a TAPI 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 TAPI.