mensaje de PHONE_REMOVE
El mensaje de PHONE_REMOVE TAPI se envía para informar a una aplicación de la eliminación (eliminación del sistema) de un dispositivo telefónico. Por lo general, esto no se usa para eliminaciones temporales, como la extracción de dispositivos PCMCIA, sino solo para eliminaciones permanentes en las que el proveedor de servicios ya no lo notificaría el proveedor de servicios si TAPI se reinicializaba.
Parámetros
-
hDevice
-
Reservado. Establecer en cero.
-
dwCallbackInstance
-
Reservado. Establecer en cero.
-
dwParam1
-
Identificador del dispositivo telefónico que se quitó.
-
dwParam2
-
Reservado. Establecer en cero.
-
dwParam3
-
Reservado. Establecer en cero.
Valor devuelto
No de devuelve ningún valor.
Comentarios
Las aplicaciones TAPI versión 2.0 o posterior se envían un mensaje de PHONE_REMOVE . Esto les informa de que el dispositivo se ha quitado del sistema. El PHONE_REMOVE mensaje está precedido por un mensaje PHONE_CLOSE en cada identificador de teléfono, si la aplicación tenía el teléfono abierto. Este mensaje se envía a todas las aplicaciones compatibles con TAPI versión 2.0 o posterior que han llamado phoneInitializeEx, incluidas las que no tienen ningún dispositivo telefónico abierto en el momento.
Las aplicaciones anteriores (que negociaban la versión 1.4 o anterior de TAPI) se envían un mensaje de PHONE_STATE que especifica PHONESTATE_REMOVED, seguido de un mensaje de PHONE_CLOSE . A diferencia del mensaje PHONE_REMOVE , sin embargo, estas aplicaciones anteriores pueden recibir estos mensajes solo si tienen el teléfono abierto cuando se quita. Si no tienen el teléfono abierto, su única indicación de que el dispositivo se quitó estaría recibiendo un PHONEERR_NODEVICE cuando intentan acceder al dispositivo.
Una vez quitado un dispositivo, cualquier intento de acceder al dispositivo por su identificador de dispositivo produce un error de PHONEERR_NODEVICE. Después de que todas las aplicaciones TAPI se hayan apagado para que TAPI pueda reiniciarse y, cuando se reinicializa TAPI, el dispositivo quitado ya no ocupa un identificador de dispositivo.
Nota
Implementación: es TAPI que devuelve este mensaje de PHONEERR_NODEVICE después de recibir un mensaje de PHONE_REMOVE de un proveedor de servicios; no se realizan más llamadas a ese proveedor de servicios mediante ese identificador de dispositivo telefónico.
Requisitos
| Requisito | Value |
|---|---|
| Versión de TAPI |
Requiere TAPI 2.0 o posterior |
| Encabezado |
|