Función lineSetAppSpecific (tapi.h)
La función lineSetAppSpecific permite a una aplicación establecer el campo específico de la aplicación del registro de información de llamada de la llamada especificada.
Sintaxis
LONG lineSetAppSpecific(
HCALL hCall,
DWORD dwAppSpecific
);
Parámetros
hCall
Controle la llamada cuyo campo específico de la aplicación debe establecerse. La aplicación debe ser propietario de la llamada. El estado de llamada de hCall puede ser cualquier estado.
dwAppSpecific
Nuevo contenido del miembro dwAppSpecific para la estructura LINECALLINFO de la llamada. La API de telefonía no interpreta este valor.
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_NOMEM, LINEERR_UNINITIALIZED, LINEERR_NOTOWNER, LINEERR_OPERATIONUNAVAIL, LINEERR_OPERATIONFAILED.
Comentarios
La API de telefonía ni ninguno de sus proveedores de servicios interpreta el campo específico de la aplicación en la estructura de datos LINECALLINFO que existe para cada llamada. Las aplicaciones definen completamente su uso. El campo se puede leer desde el registro LINECALLINFO devuelto por lineGetCallInfo. Sin embargo, lineSetAppSpecific debe usarse para establecer el campo para que los cambios sean visibles para otras aplicaciones. Cuando se cambia este campo, todas las demás aplicaciones con identificadores de llamada se envían un mensaje de LINE_CALLINFO con una indicación de que el miembro dwAppSpecific ha cambiado.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | tapi.h |
| Library | Tapi32.lib |
| Archivo DLL | Tapi32.dll |
Consulte también
Referencia básica de servicios de telefonía