PHONE_REMOVE mensagem
A mensagem PHONE_REMOVE TAPI é enviada para informar um aplicativo sobre a remoção (exclusão do sistema) de um dispositivo de telefone. 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 telefone que foi removido.
-
Dwparam2
-
Reservado. Defina como zero.
-
dwParam3
-
Reservado. Defina como zero.
Valor retornado
Sem valor de retorno.
Comentários
Aplicativos TAPI versão 2.0 ou posterior são enviados uma mensagem PHONE_REMOVE . Isso informa que o dispositivo foi removido do sistema. A mensagem PHONE_REMOVE é precedida por uma mensagem PHONE_CLOSE em cada identificador de telefone, se o aplicativo tiver o telefone aberto. Essa mensagem é enviada a todos os aplicativos que dão suporte à TAPI versão 2.0 ou posterior que tenham chamado phoneInitializeEx, incluindo aqueles que não têm nenhum dispositivo de telefone aberto no momento.
Aplicativos mais antigos (que negociavam o TAPI versão 1.4 ou anterior) são enviados uma mensagem PHONE_STATE especificando PHONESTATE_REMOVED, seguida por uma mensagem de PHONE_CLOSE . Ao contrário da mensagem PHONE_REMOVE , no entanto, esses aplicativos mais antigos só poderão receber essas mensagens se tiverem o telefone aberto quando ele for removido. Se eles não tiverem o telefone aberto, sua única indicação de que o dispositivo foi removido estaria recebendo uma PHONEERR_NODEVICE quando 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 PHONEERR_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: é o TAPI que retorna essa mensagem PHONEERR_NODEVICE depois que uma mensagem de PHONE_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 telefone.
Requisitos
| Requisito | Valor |
|---|---|
| Versão do TAPI |
Requer TAPI 2.0 ou posterior |
| Cabeçalho |
|