Función lineGetLineDevStatus (tapi.h)

Artículo
03/02/2024

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.