função TSPI_lineReleaseUserUserInfo (tspi.h)
A função TSPI_lineReleaseUserUserInfo informa ao provedor de serviços que as informações de usuário-usuário contidas na estrutura LINECALLINFO foram processadas 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 TSPIAPI TSPI_lineReleaseUserUserInfo(
DRV_REQUESTID dwRequestID,
HDRVCALL hdCall
);
Parâmetros
dwRequestID
O identificador da solicitação assíncrona.
hdCall
O identificador do provedor de serviços para a chamada para a qual as informações de usuário-usuário devem ser liberadas. O estado de chamada de hdCall pode ser qualquer.
Retornar valor
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_NOMEM, LINEERR_RESOURCEUNAVAIL.
Comentários
A função TSPI_lineReleaseUserUserInfo permite o controle do 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 TAPI usando uma mensagem LINE_CALLINFO (especificando LINECALLINFOSTATE_USERUSERINFO). As informações do usuário e outros campos em LINECALLINFO podem ser examinados por várias chamadas para TSPI_lineGetCallInfo. O provedor de serviços não deve substituir informações anteriores do usuário no LINECALLINFO com informações mais recentes até que TSPI_lineReleaseUserUserInfo tenha sido chamado. O provedor de serviços deve armazenar em buffer as informações de usuário-usuário recebidas posteriormente até que as informações anteriores sejam liberadas. Todas as informações restantes em buffer podem ser descartadas quando TSPI_lineCloseCall é invocado.
Se essa função for invocada enquanto não houver informações de usuário no LINECALLINFO, o provedor de serviços deverá, no entanto, retornar uma indicação de êxito.
Para compatibilidade com versões anteriores, o TAPI retornará automaticamente LINEERR_OPERATIONUNAVAIL se essa função for invocada para uma chamada em uma linha sob o controle de um provedor de serviços que não exporta a função.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | tspi.h |