PHONE_REMOVE messaggio
Il messaggio TAPI PHONE_REMOVE viene inviato per informare un'applicazione della rimozione (eliminazione dal sistema) di un dispositivo telefonico. In genere, questo non viene usato per le rimozione temporanee, ad esempio l'estrazione di dispositivi PCMCIA, ma solo per le rimozione permanenti in cui il dispositivo non verrà più segnalato dal provider di servizi se TAPI è stato reinizializzato.
Parametri
-
hDevice
-
Riservato. Imposta su zero.
-
dwCallbackInstance
-
Riservato. Imposta su zero.
-
dwParam1
-
Identificatore del dispositivo telefonico rimosso.
-
dwParam2
-
Riservato. Imposta su zero.
-
dwParam3
-
Riservato. Imposta su zero.
Valore restituito
Nessun valore restituito.
Commenti
Le applicazioni TAPI versione 2.0 o successiva vengono inviate un messaggio di PHONE_REMOVE . Ciò informa che il dispositivo è stato rimosso dal sistema. Il messaggio PHONE_REMOVE è preceduto da un messaggio PHONE_CLOSE su ogni handle telefonico, se l'applicazione ha aperto il telefono. Questo messaggio viene inviato a tutte le applicazioni che supportano TAPI versione 2.0 o successiva che hanno chiamato phoneInitializeEx, incluse quelle che non hanno dispositivi telefonici aperti al momento.
Le applicazioni meno recenti (che hanno negoziato TAPI versione 1.4 o versioni precedenti) vengono inviate un messaggio PHONE_STATE che specifica PHONESTATE_REMOVED, seguito da un messaggio di PHONE_CLOSE. A differenza del messaggio PHONE_REMOVE , tuttavia, queste applicazioni precedenti possono ricevere questi messaggi solo se hanno il telefono aperto quando viene rimosso. Se non hanno aperto il telefono, l'unica indicazione che il dispositivo è stato rimosso riceverà un PHONEERR_NODEVICE quando tentano di accedere al dispositivo.
Dopo la rimozione di un dispositivo, qualsiasi tentativo di accesso al dispositivo da parte dell'identificatore del dispositivo genera un errore di PHONEERR_NODEVICE. Dopo l'arresto di tutte le applicazioni TAPI, in modo che TAPI possa essere riavviato e quando TAPI viene reinizializzato, il dispositivo rimosso non occupa più un identificatore del dispositivo.
Nota
Implementazione: è TAPI che restituisce questo messaggio PHONEERR_NODEVICE dopo la ricezione di un messaggio di PHONE_REMOVE da un provider di servizi; non vengono effettuate ulteriori chiamate a tale provider di servizi usando tale identificatore di dispositivo telefonico.
Requisiti
| Requisito | Valore |
|---|---|
| Versione TAPI |
Richiede TAPI 2.0 o versione successiva |
| Intestazione |
|