LINE_REMOVE mensagem

A mensagem LINE_REMOVE TAPI é enviada para informar um aplicativo sobre a remoção (exclusão do sistema) de um dispositivo de linha. Geralmente, isso não é usado para remoções temporárias, como extração de dispositivos PCMCIA, mas apenas para remoções permanentes nas quais o dispositivo não seria mais relatado pelo provedor de serviços se o TAPI fosse reinicializado.

Parâmetros

hDevice

Reservado. Defina como zero.

dwCallbackInstance

Reservado. Defina como zero.

Dwparam1

Identificador do dispositivo de linha que foi removido.

Dwparam2

Reservado. Defina como zero.

dwParam3

Reservado. Defina como zero.

Valor retornado

Sem valor de retorno.

Comentários

Os aplicativos que dão suporte à TAPI versão 2.0 ou posterior são enviados LINE_REMOVE mensagem. Isso informa que o dispositivo foi removido do sistema. A mensagem LINE_REMOVE é precedida por uma mensagem LINE_CLOSE em cada identificador de linha, se o aplicativo tiver a linha aberta. Essa mensagem é enviada a todos os aplicativos que dão suporte à TAPI versão 2.0 ou posterior que chamaram lineInitializeEx, incluindo aqueles que não têm nenhum dispositivo de linha aberto no momento.

Os aplicativos mais antigos recebem uma mensagem LINE_LINEDEVSTATE especificando LINEDEVSTATE_REMOVED, seguida de uma mensagem LINE_CLOSE. Ao contrário da mensagem LINE_REMOVE , no entanto, esses aplicativos mais antigos só poderão receber essas mensagens se tiverem a linha aberta quando ela for removida. Se eles não tiverem a linha aberta, sua única indicação de que o dispositivo foi removido estaria recebendo um erro LINEERR_NODEVICE ao tentar acessar o dispositivo.

Depois que um dispositivo for removido, qualquer tentativa de acessar o dispositivo por seu identificador de dispositivo resultará em um erro de LINEERR_NODEVICE. Depois que todos os aplicativos TAPI tiverem desligamento para que o TAPI possa ser reiniciado e quando o TAPI for reinicializado, o dispositivo removido não ocupará mais um identificador de dispositivo.

Observação

Implementação: é TAPI que retorna esse LINEERR_NODEVICE; depois que uma mensagem de LINE_REMOVE é recebida de um provedor de serviços; não são feitas chamadas adicionais para esse provedor de serviços usando esse identificador de dispositivo de linha.

Requisitos

Requisito	Valor
Versão do TAPI	Requer TAPI 2.0 ou posterior
Cabeçalho	Tapi.h

Confira também

LINE_CLOSE

LINE_LINEDEVSTATE

Lineinitializeex