Leer en inglés

Compartir a través de


mensaje de LINE_REMOVE

El mensaje de LINE_REMOVE TAPI se envía para informar a una aplicación de la eliminación (eliminación del sistema) de un dispositivo de línea. 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 dispositivo ya no sería notificado por el proveedor de servicios si TAPI se reinicializaba.

            

Parámetros

hDevice

Reservado. Establecer en cero.

dwCallbackInstance

Reservado. Establecer en cero.

dwParam1

Identificador del dispositivo de línea que se quitó.

dwParam2

Reservado. Establecer en cero.

dwParam3

Reservado. Establecer en cero.

Valor devuelto

No de devuelve ningún valor.

Comentarios

Las aplicaciones compatibles con TAPI versión 2.0 o posterior se envían un mensaje de LINE_REMOVE . Esto les informa de que el dispositivo se ha quitado del sistema. El mensaje LINE_REMOVE va precedido de un mensaje LINE_CLOSE en cada identificador de línea, si la aplicación tenía abierta la línea. Este mensaje se envía a todas las aplicaciones compatibles con TAPI versión 2.0 o posterior que han llamado lineInitializeEx, incluidas las que no tienen ningún dispositivo de línea abierto en el momento.

Las aplicaciones anteriores se envían un mensaje de LINE_LINEDEVSTATE que especifica LINEDEVSTATE_REMOVED, seguido de un mensaje de LINE_CLOSE. A diferencia del mensaje LINE_REMOVE , sin embargo, estas aplicaciones anteriores solo pueden recibir estos mensajes si tienen la línea abierta cuando se quita. Si no tienen abierta la línea, su única indicación de que el dispositivo se quitó recibiría un error de LINEERR_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 LINEERR_NODEVICE. Después de que todas las aplicaciones TAPI tengan apagado para que TAPI pueda reiniciarse y cuando TAPI se reinicializa, el dispositivo quitado ya no ocupa un identificador de dispositivo.

Nota

Implementación: es TAPI que devuelve este LINEERR_NODEVICE; después de recibir un mensaje de LINE_REMOVE de un proveedor de servicios; no se realizan más llamadas a ese proveedor de servicios mediante ese identificador de dispositivo de línea.

Requisitos

Requisito Value
Versión de TAPI
Requiere TAPI 2.0 o posterior
Encabezado
Tapi.h

Consulte también

LINE_CLOSE

LINE_LINEDEVSTATE

lineInitializeEx