LINE_REMOVE mensagem

A mensagem LINE_REMOVE TAPI é enviada para informar um aplicativo da 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. Definido como zero.

dwCallbackInstance

Reservado. Definido como zero.

Dwparam1

Identificador do dispositivo de linha que foi removido.

Dwparam2

Reservado. Definido como zero.

dwParam3

Reservado. Definido como zero.

Valor retornado

Sem valor de retorno.

Comentários

Os aplicativos que dão suporte ao 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.

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 é removido, qualquer tentativa de acessar o dispositivo por seu identificador de dispositivo resulta em um erro LINEERR_NODEVICE. Depois que todos os aplicativos TAPI tiverem o 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: é o TAPI que retorna esse LINEERR_NODEVICE; depois que uma mensagem 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