Función lineGetCallInfo (tapi.h)
La función lineGetCallInfo permite a una aplicación obtener información fija sobre la llamada especificada.
Sintaxis
LONG lineGetCallInfo(
HCALL hCall,
LPLINECALLINFO lpCallInfo
);
Parámetros
hCall
Identificador de la llamada que se va a consultar. El estado de llamada de hCall puede ser cualquier estado.
lpCallInfo
Puntero a una estructura de datos de tamaño variable de tipo LINECALLINFO. Tras completar correctamente la solicitud, esta estructura se rellena con información relacionada con llamadas. Antes de llamar a lineGetCallInfo, la aplicación debe establecer el miembro dwTotalSize de esta estructura para indicar la cantidad de memoria disponible para TAPI para devolver información.
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:
LINEERR_INVALCALLHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NOMEM, LINEERR_UNINITIALIZED, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL.
Comentarios
Existe una estructura LINECALLINFO independiente para cada llamada entrante o saliente. La estructura contiene principalmente información fija sobre la llamada. Normalmente, una aplicación estaría interesada en comprobar esta información cuando recibe su identificador para una llamada por el mensaje LINE_CALLSTATE , o cada vez que recibe una notificación por un mensaje de LINE_CALLINFO que han cambiado las partes de la estructura de información de llamadas. Estos mensajes proporcionan el identificador de la llamada como parámetro.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | tapi.h |
| Library | Tapi32.lib |
| Archivo DLL | Tapi32.dll |