Struttura LINEADDRESSSTATUS (tapi.h)
La struttura LINEADDRESSSTATUS descrive lo stato corrente di un indirizzo. La funzione lineGetAddressStatus e la funzione TSPI_lineGetAddressStatus restituiscono la struttura LINEADDRESSSTATUS .
Sintassi
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;
Members
dwTotalSize
Dimensioni totali assegnate a questa struttura di dati, in byte.
dwNeededSize
Dimensioni per questa struttura di dati necessaria per contenere tutte le informazioni restituite, in byte.
dwUsedSize
Dimensioni della parte di questa struttura di dati che contiene informazioni utili, in byte.
dwNumInUse
Numero di stazioni attualmente in uso.
dwNumActiveCalls
Numero di chiamate sull'indirizzo che si trovano in stati di chiamata diversi da inattività, onhold, onholdpendingtransfer e onholdpendingconference.
dwNumOnHoldCalls
Numero di chiamate sull'indirizzo nello stato onhold .
dwNumOnHoldPendCalls
Numero di chiamate sull'indirizzo nello stato onholdpendingtransfer o onholdpendingconference .
dwAddressFeatures
Funzioni correlate agli indirizzi che possono essere richiamate sull'indirizzo nello stato corrente. Questo membro usa una o più costanti LINEADDRFEATURE_.
dwNumRingsNoAnswer
Numero di anelli impostati per questo indirizzo prima che una chiamata senza risposta sia considerata nessuna risposta.
dwForwardNumEntries
Numero di voci nella matrice a cui fa riferimento dwForwardSize e dwForwardOffset.
dwForwardSize
Dimensioni della matrice di informazioni di inoltro, in byte.
dwForwardOffset
Offset dall'inizio della struttura al campo di dimensioni variabile che descrive le informazioni sull'inoltro dell'indirizzo. Queste informazioni sono una matrice di elementi dwForwardNumEntries , di tipo LINEFORWARD. Gli offset degli indirizzi nella matrice sono relativi all'inizio della struttura LINEADDRESSSTATUS . Gli offset dwCallerAddressOffset e dwDestAddressOffset nel campo variabile di tipo LINEFORWARD puntato da dwForwardOffset sono relativi all'inizio della struttura di dati LINEADDRESSSTATUS (contenitore "radice"). Le dimensioni della matrice sono specificate da dwForwardSize.
dwTerminalModesSize
Dimensioni della matrice delle modalità terminale, in byte.
dwTerminalModesOffset
Offset dall'inizio della struttura al campo dispositivo di dimensioni variabile contenente una matrice con voci di dimensioni DWORD, che usano una o più costanti LINETERMMODE_. Questa matrice viene indicizzata dagli identificatori del terminale, nell'intervallo compreso tra zero e uno minore di dwNumTerminals. Ogni voce della matrice specifica le modalità del terminale correnti per il set di terminale corrispondente con la funzione lineSetTerminal per questo indirizzo. Le dimensioni della matrice sono specificate da dwTerminalModesSize.
dwDevSpecificSize
Dimensioni del campo specifico del dispositivo, in byte.
dwDevSpecificOffset
Offset dall'inizio di questa struttura al campo specifico del dispositivo di dimensioni variabile. La dimensione del campo è specificata da dwDevSpecificSize.
Commenti
Le estensioni specifiche del dispositivo devono usare l'area devSpecific (dwDevSpecificSize e dwDevSpecificOffset) variamente ridimensionata di questa struttura di dati.
Questa struttura di dati viene restituita dalla funzione lineGetAddressStatus . Quando gli elementi in questa struttura di dati cambiano come conseguenza delle attività sull'indirizzo, viene inviato un messaggio LINE_ADDRESSSTATE all'applicazione. Un parametro per questo messaggio è lo stato dell'indirizzo, una delle costanti LINEADDRESSSTATE_, che indica che l'elemento di stato di questo record è cambiato.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | tapi.h |