función TSPI_phoneClose (tspi.h)
La función TSPI_phoneClose cierra el dispositivo telefónico abierto especificado después de completar o anular todas las operaciones asincrónicas pendientes en el dispositivo.
Sintaxis
LONG TSPIAPI TSPI_phoneClose(
HDRVPHONE hdPhone
);
Parámetros
hdPhone
El identificador opaco del proveedor de servicios al teléfono que se va a cerrar. Una vez cerrado correctamente el teléfono, este identificador ya no es válido.
Valor devuelto
Devuelve cero si la función se ejecuta correctamente o un número de error si se produce un error. Los valores devueltos posibles son los siguientes:
PHONEERR_INVALPHONEHANDLE, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_RESOURCEUNAVAIL.
Comentarios
El proveedor de servicios debe notificar la finalización de cada operación asincrónica. Si se llama a este procedimiento para un teléfono en el que hay operaciones asincrónicas pendientes, las operaciones se deben notificar completadas con un resultado o código de error adecuado antes de que este procedimiento devuelva. Por lo general, TAPI espera que se completen de forma ordenada. Sin embargo, el proveedor de servicios debe estar preparado para controlar una llamada temprana a TSPI_phoneClose en situaciones de "anulación" o "apagado de emergencia".
Después de que este procedimiento devuelva el proveedor de servicios, no debe informar de ningún evento adicional en el teléfono. El identificador opaco del proveedor de servicios para el teléfono deja de ser válido.
El proveedor de servicios debe renunciar a recursos no compartidos que se reservan mientras el teléfono está abierto. Por ejemplo, cerrar un teléfono al que se accede a través de un puerto y módem debe dar lugar a cerrar el puerto comm, lo que hace que esté disponible para su uso por otras aplicaciones.
Esta función siempre debe realizarse correctamente, excepto en circunstancias extraordinarias. La mayoría de los autores de llamadas probablemente omitirán el código de retorno porque no podrán compensar los errores que se produzcan. Los valores devueltos especificados son más avisos para fines de diagnóstico de desarrollo que cualquier otra cosa.
Requisitos
Plataforma de destino | Windows |
Encabezado | tspi.h |