TSPI_lineCloseCall
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/19/2008
Essa função Desaloca a chamar após a conclusão ou anulando pendente todos os assíncrono operações na chamar.
Syntax
LONG TSPIAPI TSPI_lineCloseCall(
HDRVCALL hdCall
);
Parameters
- hdCall
Serviço identificador do provedor para a chamar a ser fechado. Após a chamar é fechada com êxito, esse identificador é não mais válido. O estado chamar pode ser qualquer estado.
Return Value
Retorna zero se a função for bem-sucedido ou um número de erro se ocorrer um erro. A seguinte tabela mostra os valores de retorno para esta função.
| Valor | Descrição |
|---|---|
LINEERR_NOMEM |
Não há memória o suficiente disponível. |
LINEERR_OPERATIONFAILED |
A operação falhou. |
LINEERR_OPERATIONUNAVAIL |
A operação é não disponível. |
LINEERR_RESOURCEUNAVAIL |
O recurso não está disponível. |
Remarks
Provedor de serviço deve conclusão relatório assíncrono operações. Se TSPI_lineCloseCall é chamado para uma chamar no qual lá é pendente assíncrono operações, as operações devem ser reportados completo com um apropriado resultado ou código de erro antes de Que Retorna este procedimento. Após esse procedimento retorna, provedor de serviço deve relatório não eventos adicionais na chamar. Alças do provedor de serviços para a linha e chamadas sobre a linha que se tornam "inválido."
TAPI não chamar TSPI_lineCloseCall Se um provedor de serviços sincronicamente retornará um erro de um chamar para o TSPI_lineMakeCall função. Mas chamar TAPI TSPI_lineCloseCall Se o provedor serviço retornará um erro a partir de operação assíncrona iniciada por TSPI_lineMakeCall.
Se houver um ativo chamar na linha no tempo de TSPI_lineCloseCall, a chamar deve ser cancelado se esse comportamento é indicado pelo bit LINEDEVCAPFLAGS_CLOSEDROP in a LINEDEVCAPS estrutura.
Se o provedor serviço pode determinar que há outro agente compartilhamento controle do chamar, como as in uma parte linha situação com um separar monofone, provedor de serviço simplesmente permite controle de transmitir a chamar para o outro agente rather than forçosamente soltando.
Esta função deve sempre será bem sucedida, exceto em circunstâncias extraordinária. A maioria dos chamadores provavelmente irá ignorar o código de retorno porque eles serão consiga compensar qualquer erro que ocorre. Especificado retornar os valores são mais de consultoria para fins de diagnóstico desenvolvimento que nada.
Essa função é chamado quando o último aplicativo com um identificador para este chamar executa o lineDeallocateCall função.
Requirements
| Header | tapicomn.h |
| Library | coredll.lib |
| Windows Embedded CE | Windows CE 3.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |