Función lineGetLineDevStatus (tapi.h)
La función lineGetLineDevStatus permite a una aplicación consultar el dispositivo de línea abierta especificado para su estado actual.
Sintaxis
LONG lineGetLineDevStatus(
HLINE hLine,
LPLINEDEVSTATUS lpLineDevStatus
);
Parámetros
hLine
Controle el dispositivo de línea abierta que se va a consultar.
lpLineDevStatus
Puntero a una estructura de datos de tamaño variable de tipo LINEDEVSTATUS. Una vez completada correctamente la solicitud, esta estructura se rellena con el estado del dispositivo de la línea. Antes de llamar a lineGetLineDevStatus, 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_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NOMEM, LINEERR_UNINITIALIZED, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL.
Comentarios
Una aplicación usa lineGetLineDevStatus para consultar el dispositivo de línea para su estado de línea actual. Esta información de estado se aplica globalmente a todas las direcciones del dispositivo de línea. Use lineGetAddressStatus para determinar la información de estado sobre una dirección específica en una línea.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | tapi.h |
| Library | Tapi32.lib |
| Archivo DLL | Tapi32.dll |
Consulte también
Referencia de servicios de telefonía básica