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
Tapi.h

Vedi anche

LINE_CLOSE

LINE_LINEDEVSTATE

lineInitializeEx