función TSPI_lineSetAppSpecific (tspi.h)
La función TSPI_lineSetAppSpecific establece el campo específico de la aplicación de la estructura LINECALLINFO de la llamada especificada.
Sintaxis
LONG TSPIAPI TSPI_lineSetAppSpecific(
HDRVCALL hdCall,
DWORD dwAppSpecific
);
Parámetros
hdCall
Identificador de la llamada cuyo campo específico de la aplicación se va a establecer. El estado de llamada de hdCall puede ser cualquier estado.
dwAppSpecific
Nuevo contenido del miembro dwAppSpecific de la estructura LINECALLINFO de la llamada. El proveedor de servicios no interpreta este valor. TAPI no valida este parámetro cuando se llama a esta función.
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:
LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL, LINEERR_OPERATIONUNAVAIL.
Comentarios
El campo específico de la aplicación en la estructura de datos LINECALLINFO que existe para cada llamada no estáinterpretado por la API de telefonía o por cualquiera de sus proveedores de servicios. Las aplicaciones definen completamente su uso. El campo se puede leer del registro LINECALLINFO devuelto por TSPI_lineGetCallInfo. Sin embargo, TSPI_lineSetAppSpecific se debe usar para establecer el campo para que los cambios sean visibles para otras aplicaciones. Cuando se cambia este campo, el proveedor de servicios envía un mensaje de LINE_CALLINFO con una indicación de que el campo AppSpecific ha cambiado.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | tspi.h |