LINE_REMOVE messaggio
Il messaggio TAPI LINE_REMOVE viene inviato per informare un'applicazione della rimozione (eliminazione dal sistema) di un dispositivo linea. 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 della riga rimosso.
-
dwParam2
-
Riservato. Imposta su zero.
-
dwParam3
-
Riservato. Imposta su zero.
Valore restituito
Nessun valore restituito.
Commenti
Le applicazioni che supportano TAPI versione 2.0 o successiva vengono inviate un messaggio di LINE_REMOVE . Ciò informa che il dispositivo è stato rimosso dal sistema. Il messaggio LINE_REMOVE è preceduto da un messaggio di LINE_CLOSE su ogni handle di riga, se l'applicazione ha aperto la riga. Questo messaggio viene inviato a tutte le applicazioni che supportano TAPI versione 2.0 o successiva che hanno chiamato lineInitializeEx, inclusi quelli che non dispongono di dispositivi di riga aperti al momento.
Le applicazioni meno recenti vengono inviate un messaggio di LINE_LINEDEVSTATE che specifica LINEDEVSTATE_REMOVED, seguito da un messaggio di LINE_CLOSE. A differenza del messaggio LINE_REMOVE , tuttavia, queste applicazioni precedenti possono ricevere questi messaggi solo se hanno la riga aperta quando viene rimossa. Se non hanno la riga aperta, l'unica indicazione che il dispositivo è stato rimosso riceverà un errore di LINEERR_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 LINEERR_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 questa LINEERR_NODEVICE; dopo la ricezione di un messaggio di LINE_REMOVE da un provider di servizi; non vengono effettuate ulteriori chiamate a tale provider di servizi usando tale identificatore del dispositivo di riga.
Requisiti
| Requisito | Valore |
|---|---|
| Versione TAPI |
Richiede TAPI 2.0 o versione successiva |
| Intestazione |
|