Estrutura LINEADDRESSSTATUS (tapi.h)
A estrutura LINEADDRESSSTATUS descreve o status atual de um endereço. A função lineGetAddressStatus e a função TSPI_lineGetAddressStatus retornam a estrutura LINEADDRESSSTATUS .
Sintaxe
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;
Membros
dwTotalSize
Tamanho total alocado para essa estrutura de dados, em bytes.
dwNeededSize
Tamanho para essa estrutura de dados necessária para armazenar todas as informações retornadas, em bytes.
dwUsedSize
Tamanho da parte dessa estrutura de dados que contém informações úteis, em bytes.
dwNumInUse
Número de estações que estão usando o endereço no momento.
dwNumActiveCalls
Número de chamadas no endereço que estão em estados de chamada diferentes de idle, onhold, onholdpendingtransfer e onholdpendingconference.
dwNumOnHoldCalls
Número de chamadas no endereço no estado de retenção .
dwNumOnHoldPendCalls
Número de chamadas no endereço no estado onholdpendingtransfer ou onholdpendingconference .
dwAddressFeatures
Funções relacionadas ao endereço que podem ser invocadas no endereço em seu estado atual. Esse membro usa uma ou mais das constantes LINEADDRFEATURE_.
dwNumRingsNoAnswer
O número de anéis definidos para esse endereço antes de uma chamada sem resposta é considerado como nenhuma resposta.
dwForwardNumEntries
Número de entradas na matriz referida por dwForwardSize e dwForwardOffset.
dwForwardSize
Tamanho da matriz de informações de encaminhamento, em bytes.
dwForwardOffset
Deslocamento do início da estrutura para o campo de tamanho variável que descreve as informações de encaminhamento do endereço. Essas informações são uma matriz de elementos dwForwardNumEntries , do tipo LINEFORWARD. Os deslocamentos dos endereços na matriz são relativos ao início da estrutura LINEADDRESSSTATUS . Os deslocamentos dwCallerAddressOffset e dwDestAddressOffset no campo de tamanho variável do tipo LINEFORWARD apontado por dwForwardOffset são relativos ao início da estrutura de dados LINEADDRESSSTATUS (o contêiner "raiz"). O tamanho da matriz é especificado por dwForwardSize.
dwTerminalModesSize
Tamanho da matriz de modos de terminal, em bytes.
dwTerminalModesOffset
Deslocamento do início da estrutura para o campo de dispositivo de tamanho variável que contém uma matriz com entradas do tamanho DWORD, que usam uma ou mais das constantes LINETERMMODE_. Essa matriz é indexada por identificadores de terminal, no intervalo de zero a um a menos que dwNumTerminals. Cada entrada na matriz especifica os modos de terminal atuais para o conjunto de terminais correspondente com a função lineSetTerminal para esse endereço. O tamanho da matriz é especificado por dwTerminalModesSize.
dwDevSpecificSize
Tamanho do campo específico do dispositivo, em bytes.
dwDevSpecificOffset
Deslocamento do início dessa estrutura para o campo específico do dispositivo de tamanho variável. O tamanho do campo é especificado por dwDevSpecificSize.
Comentários
As extensões específicas do dispositivo devem usar a área de tamanho variável DevSpecific (dwDevSpecificSize e dwDevSpecificOffset) dessa estrutura de dados.
Essa estrutura de dados é retornada pela função lineGetAddressStatus . Quando os itens nessa estrutura de dados são alterados como consequência das atividades no endereço, uma mensagem LINE_ADDRESSSTATE é enviada ao aplicativo. Um parâmetro para essa mensagem é o estado de endereço, uma das constantes LINEADDRESSSTATE_, que indica que o item status nesse registro foi alterado.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | tapi.h |