Estructura LINEADDRESSSTATUS (tapi.h)
La estructura LINEADDRESSSTATUS describe el estado actual de una dirección. La función lineGetAddressStatus y la función TSPI_lineGetAddressStatus devuelven la estructura LINEADDRESSSTATUS .
Sintaxis
typedef struct lineaddressstatus_tag {
DWORD dwTotalSize;
DWORD dwNeededSize;
DWORD dwUsedSize;
DWORD dwNumInUse;
DWORD dwNumActiveCalls;
DWORD dwNumOnHoldCalls;
DWORD dwNumOnHoldPendCalls;
DWORD dwAddressFeatures;
DWORD dwNumRingsNoAnswer;
DWORD dwForwardNumEntries;
DWORD dwForwardSize;
DWORD dwForwardOffset;
DWORD dwTerminalModesSize;
DWORD dwTerminalModesOffset;
DWORD dwDevSpecificSize;
DWORD dwDevSpecificOffset;
} LINEADDRESSSTATUS, *LPLINEADDRESSSTATUS;
Miembros
dwTotalSize
Tamaño total asignado a esta estructura de datos, en bytes.
dwNeededSize
Tamaño de esta estructura de datos necesaria para contener toda la información devuelta, en bytes.
dwUsedSize
Tamaño de la parte de esta estructura de datos que contiene información útil, en bytes.
dwNumInUse
Número de estaciones que actualmente usan la dirección.
dwNumActiveCalls
Número de llamadas en la dirección que se encuentran en estados de llamada distintos de inactivos, de retención, onholdpendingtransfer y onholdpendingconference.
dwNumOnHoldCalls
Número de llamadas en la dirección en estado de retención .
dwNumOnHoldPendCalls
Número de llamadas en la dirección en el estado onholdpendingtransfer o onholdpendingconference .
dwAddressFeatures
Funciones relacionadas con direcciones que se pueden invocar en la dirección en su estado actual. Este miembro usa una o varias de las constantes LINEADDRFEATURE_.
dwNumRingsNoAnswer
Número de anillos establecidos para esta dirección antes de que una llamada sin respuesta se considere como ninguna respuesta.
dwForwardNumEntries
Número de entradas de la matriz a las que hace referencia dwForwardSize y dwForwardOffset.
dwForwardSize
Tamaño de la matriz de información de reenvío, en bytes.
dwForwardOffset
Desplazamiento desde el principio de la estructura hasta el campo de tamaño variable que describe la información de reenvío de la dirección. Esta información es una matriz de elementos dwForwardNumEntries , de tipo LINEFORWARD. Los desplazamientos de las direcciones de la matriz son relativos al principio de la estructura LINEADDRESSSTATUS . Los desplazamientos dwCallerAddressOffset y dwDestAddressOffset en el campo de tamaño variable de tipo LINEFORWARD al que apunta dwForwardOffset son relativos al principio de la estructura de datos LINEADDRESSSTATUS (el contenedor "raíz"). DwForwardSize especifica el tamaño de la matriz.
dwTerminalModesSize
Tamaño de la matriz de modos de terminal, en bytes.
dwTerminalModesOffset
Desplazamiento desde el principio de la estructura hasta el campo de dispositivo de tamaño variable que contiene una matriz con entradas de tamaño DWORD, que usan una o varias de las constantes de LINETERMMODE_. Esta matriz se indexa mediante identificadores de terminal, en el intervalo de cero a uno menor que dwNumTerminals. Cada entrada de la matriz especifica los modos de terminal actuales para el conjunto de terminales correspondiente con la función lineSetTerminal para esta dirección. El tamaño de la matriz se especifica mediante dwTerminalModesSize.
dwDevSpecificSize
Tamaño del campo específico del dispositivo, en bytes.
dwDevSpecificOffset
Desfase desde el principio de esta estructura hasta el campo específico del dispositivo de tamaño variable. El tamaño del campo se especifica mediante dwDevSpecificSize.
Comentarios
Las extensiones específicas del dispositivo deben usar el área de tamaño variable DevSpecific (dwDevSpecificSize y dwDevSpecificOffset) de esta estructura de datos.
La función lineGetAddressStatus devuelve esta estructura de datos. Cuando los elementos de esta estructura de datos cambian como consecuencia de las actividades en la dirección, se envía un mensaje de LINE_ADDRESSSTATE a la aplicación. Un parámetro para este mensaje es el estado de dirección, una de las constantes LINEADDRESSSTATE_, que indica que el elemento de estado de este registro cambió.
Requisitos
| Requisito | Valor |
|---|---|
| Header | tapi.h |