função TSPI_lineClose (tspi.h)

Artigo
03/03/2024

A função TSPI_lineClose fecha o dispositivo de linha aberta especificado depois de concluir ou anular todas as chamadas pendentes e operações assíncronas no dispositivo.

Sintaxe

LONG TSPIAPI TSPI_lineClose(
  HDRVLINE hdLine
);

Parâmetros

hdLine

O identificador do provedor de serviços para a linha a ser fechada. Depois que a linha for fechada com êxito, esse identificador não será mais válido.

Retornar valor

Retornará 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_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL.

Comentários

O provedor de serviços deve relatar a conclusão de cada operação assíncrona. Se TSPI_lineClose for chamado para uma linha na qual há operações assíncronas pendentes, as operações serão relatadas com um resultado apropriado ou código de erro antes que este procedimento retorne.

Existe um requisito semelhante para chamadas ativas na linha. As operações pendentes devem ser relatadas com códigos de resultado ou erro apropriados. Chamadas ativas também devem ser descartadas, se necessário, e se esse comportamento foi indicado pelo bit LINEDEVCAPFLAGS_CLOSEDROP na estrutura LINEDEVCAPS .

Depois que esse procedimento retornar, o provedor de serviços não deverá relatar mais htCall na linha ou chamadas que estavam na linha. Os identificadores do provedor de serviços para a linha e as chamadas na linha tornam-se "inválidos".

O provedor de serviços deve abrir mão de recursos nãoharáveis que reserva enquanto a linha está aberta. Por exemplo, fechar uma linha acessada por meio de uma porta de comm e modem deve resultar no fechamento da porta comm, tornando-a mais uma vez disponível para uso por outros aplicativos.

O provedor de serviços não emite a mensagem LINE_LINEDEVSTATE em resposta a essa invocação de função porque a linha fecha e não há mais interesse em suas alterações de estado.