Función phoneGetStatus (tapi.h)

La función phoneGetStatus permite a una aplicación consultar el dispositivo telefónico abierto especificado para su estado general.

Sintaxis

LONG phoneGetStatus(
  HPHONE        hPhone,
  LPPHONESTATUS lpPhoneStatus
);

Parámetros

hPhone

Controle el dispositivo de teléfono abierto que se va a consultar.

lpPhoneStatus

Puntero a una estructura de datos de tamaño variable de tipo PHONESTATUS, que se carga con la información devuelta sobre el estado del teléfono.

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_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_OPERATIONFAILED, PHONEERR_STRUCTURETOOSMALL, PHONEERR_OPERATIONUNAVAIL, PHONEERR_UNINITIALIZED.

Comentarios

Una aplicación puede usar esta función para determinar el estado actual de un dispositivo telefónico abierto. La información de estado describe información sobre los dispositivos hookswitch del dispositivo telefónico, timbre, volumen, pantalla y lámparas.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	tapi.h
Library	Tapi32.lib
Archivo DLL	Tapi32.dll

Consulte también

PHONESTATUS

Funciones complementarias del servicio telefónico

Información general de referencia de TAPI 2.2