Condividi tramite


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

Vedi anche

PHONE_CLOSE

PHONE_STATE

phoneInitialize

phoneInitializeEx