Función phoneClose (tapi.h)

Artículo
03/02/2024

La función phoneClose cierra el dispositivo telefónico abierto especificado.

Sintaxis

LONG phoneClose(
  HPHONE hPhone
);

Parámetros

hPhone

Controle el dispositivo de teléfono abierto que se va a cerrar. Si la función se realiza correctamente, el identificador ya no es válido.

Valor devuelto

Devuelve cero si la solicitud se realiza correctamente o un número de error negativo si se produce un error. Los valores devueltos posibles son:

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_OPERATIONFAILED, PHONEERR_RESOURCEUNAVAIL, PHONEERR_OPERATIONUNAVAIL, PHONEERR_UNINITIALIZED.

Comentarios

Una vez cerrado correctamente el dispositivo telefónico abierto, la implementación envía un mensaje PHONE_CLOSE a la aplicación. Estos mensajes también se pueden enviar no solicitados como resultado de la reclamación del dispositivo telefónico de alguna manera. Por lo tanto, una aplicación debe estar preparada para controlar estos mensajes de cierre no solicitados. En el momento en que se cierra el dispositivo telefónico, se suprimen las respuestas asincrónicas pendientes.