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 |
|