Função lineReleaseUserUserInfo (tapi.h)

Artigo
08/26/2023

A função lineReleaseUserUserInfo informa ao provedor de serviços que o aplicativo processou as informações de usuário-usuário contidas na estrutura LINECALLINFO e que, posteriormente, as informações de usuário-usuário recebidas agora podem ser gravadas nessa estrutura. O provedor de serviços envia uma mensagem LINE_CALLINFO indicando LINECALLINFOSTATE_USERUSERINFO quando novas informações estão disponíveis.

Sintaxe

LONG lineReleaseUserUserInfo(
  HCALL hCall
);

Parâmetros

hCall

Manipule para a chamada. O aplicativo deve ser um proprietário da chamada. O estado de chamada de hCall pode ser qualquer estado.

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_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL, LINEERR_NOTOWNER, LINEERR_UNINITIALIZED, LINEERR_OPERATIONUNAVAIL.

Comentários

A função lineReleaseUserUserInfo permite que o aplicativo controle o fluxo de informações de usuário-usuário de entrada em uma conexão ISDN. Quando uma mensagem de informações nova e completa do usuário é recebida, o provedor de serviços informa o aplicativo usando uma mensagem LINE_CALLINFO (especificando LINECALLINFOSTATE_USERUSERINFO). Qualquer número de aplicativos pode examinar as informações (usando lineGetCallInfo), mas o aplicativo que possui os controles de chamada quando as informações são liberadas para que as informações subsequentes possam ser relatadas. O provedor de serviços não substituirá as informações anteriores do usuário-usuário em LINECALLINFO com informações mais recentes até que lineReleaseUserUserInfo tenha sido chamado. É responsabilidade do provedor de serviços armazenar em buffer as informações do usuário-usuário recebidas posteriormente até que as informações anteriores sejam liberadas pelo aplicativo que possui a chamada.