Função lineClose (tapi.h)

Artigo
03/02/2024

A função lineClose fecha o dispositivo de linha aberta especificado.

Sintaxe

LONG lineClose(
  HLINE hLine
);

Parâmetros

hLine

Identificador para o dispositivo de linha aberta a ser fechado. Depois que a linha for fechada com êxito, esse identificador não será mais válido.

Retornar valor

Retornará zero se a solicitação for bem-sucedida ou um número de erro negativo se ocorrer um erro. Os valores retornados possíveis são:

LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL.

Comentários

Se um aplicativo chamar lineClose enquanto ainda tiver chamadas ativas na linha aberta, a propriedade do aplicativo dessas chamadas será revogada. Se o aplicativo for o único proprietário dessas chamadas, as chamadas também serão descartadas. É uma boa prática de programação para um aplicativo descartar as chamadas que possui em uma linha aberta, renunciando explicitamente à propriedade e/ou descartando essas chamadas antes de fechar a linha.

Se a linha tiver sido fechada com êxito, uma mensagem de LINE_LINEDEVSTATE será enviada a todos os aplicativos que estão monitorando a linha status de alterações abertas/fechadas. As respostas assíncronas pendentes são suprimidas.

Os provedores de serviços podem achar útil ou necessário recuperar à força dispositivos de linha de um aplicativo que tem a linha aberta. Isso pode ser útil para impedir que um aplicativo monopolize o dispositivo de linha por muito tempo. Se isso acontecer, uma mensagem LINE_CLOSE será enviada ao aplicativo, especificando o identificador de linha do dispositivo de linha que foi fechado.

A função lineOpen aloca recursos para o aplicativo de invocação, e os aplicativos podem ser impedidos de abrir uma linha se os recursos não estiverem disponíveis. Portanto, um aplicativo que usa apenas ocasionalmente um dispositivo de linha (como para fazer chamadas de saída) deve fechar a linha para liberar recursos e permitir que outros aplicativos abram a linha.