Estructura LINEADDRESSSTATUS (tapi.h)

Artículo
03/02/2024

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ó.