função TSPI_lineCloseCall (tspi.h)
A função TSPI_lineCloseCall desaloca a chamada depois de concluir ou anular todas as operações assíncronas pendentes na chamada.
Sintaxe
LONG TSPIAPI TSPI_lineCloseCall(
HDRVCALL hdCall
);
Parâmetros
hdCall
O identificador do provedor de serviços para a chamada a ser fechada. Depois que a chamada for fechada com êxito, esse identificador não será mais válido. O estado da chamada pode ser qualquer estado.
Retornar valor
Retornará zero se a função for bem-sucedida ou um número de erro se ocorrer um erro. Os valores retornados possíveis são os seguintes:
LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL.
Comentários
O provedor de serviços deve relatar a conclusão para operações assíncronas. Se TSPI_lineCloseCall for chamado para uma chamada na qual há operações assíncronas pendentes, as operações deverão ser relatadas com um resultado apropriado ou código de erro antes que este procedimento retorne. Depois que esse procedimento retornar, o provedor de serviços não deverá relatar mais eventos na chamada. Os identificadores do provedor de serviços para a linha e as chamadas na linha se tornam "inválidos".
O TAPI não chamará TSPI_lineCloseCall se um provedor de serviços retornar de forma síncrona um erro de uma chamada para a função TSPI_lineMakeCall . Mas o TAPI chamará TSPI_lineCloseCall se o provedor de serviços retornar um erro da operação assíncrona iniciada pelo TSPI_lineMakeCall.
Se houver uma chamada ativa na linha no momento da TSPI_lineCloseCall, a chamada deverá ser descartada se esse comportamento for indicado pelo bit LINEDEVCAPFLAGS_CLOSEDROP na estrutura LINEDEVCAPS .
Se o provedor de serviços puder determinar que há outro controle de compartilhamento de agente da chamada, como em uma situação de linha de terceiros com um aparelho separado, o provedor de serviços simplesmente permite que o controle da chamada passe para o outro agente em vez de deixá-la à força.
Essa função sempre deve ter êxito, exceto em circunstâncias extraordinárias. A maioria dos chamadores provavelmente ignorará o código de retorno porque eles não poderão compensar nenhum erro que ocorra. Os valores retornados especificados são mais consultivos para fins de diagnóstico de desenvolvimento do que qualquer outra coisa.
Essa função é chamada quando o último aplicativo com um identificador para essa chamada executa lineDeallocateCall.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | tspi.h |