LINEADDRESSSTATUS-Struktur (tapi.h)
Die LINEADDRESSSTATUS-Struktur beschreibt die aktuelle status einer Adresse. Die lineGetAddressStatus-Funktion und die TSPI_lineGetAddressStatus-Funktion geben die LINEADDRESSSTATUS-Struktur zurück.
Syntax
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;
Member
dwTotalSize
Dieser Datenstruktur zugeordnete Gesamtgröße in Byte.
dwNeededSize
Größe für diese Datenstruktur, die benötigt wird, um alle zurückgegebenen Informationen in Bytes zu enthalten.
dwUsedSize
Größe des Teils dieser Datenstruktur, der nützliche Informationen in Byte enthält.
dwNumInUse
Anzahl der Stationen, die derzeit die Adresse verwenden.
dwNumActiveCalls
Anzahl der Aufrufe für die Adresse, die sich in anderen Anrufzuständen als "Leerlauf", "Zurückhalten", "onholdpendingtransfer" und "onholdpendingconference" befinden.
dwNumOnHoldCalls
Anzahl der Aufrufe für die Adresse im Zurückhaltungszustand .
dwNumOnHoldPendCalls
Anzahl der Aufrufe für die Adresse im Status onholdpendingtransfer oder onholdpendingconference .
dwAddressFeatures
Adressbezogene Funktionen, die für die Adresse im aktuellen Zustand aufgerufen werden können. Dieser Member verwendet eine oder mehrere der LINEADDRFEATURE_ Konstanten.
dwNumRingsNoAnswer
Die Anzahl der für diese Adresse festgelegten Ringe, bevor ein nicht beantworteter Anruf als keine Antwort betrachtet wird.
dwForwardNumEntries
Anzahl der Einträge im Array, auf das von dwForwardSize und dwForwardOffset verwiesen wird.
dwForwardSize
Größe des Weiterleitungsinformationsarrays in Bytes.
dwForwardOffset
Offset vom Anfang der Struktur bis zum Feld mit variabeler Größe, das die Weiterleitungsinformationen der Adresse beschreibt. Diese Informationen sind ein Array von dwForwardNumEntries-Elementen vom Typ LINEFORWARD. Die Offsets der Adressen im Array sind relativ zum Anfang der LINEADDRESSSTATUS-Struktur . Die Offsets dwCallerAddressOffset und dwDestAddressOffset im variabel großen Feld des Typs LINEFORWARD , auf das von dwForwardOffset verwiesen wird, sind relativ zum Anfang der LINEADDRESSSTATUS-Datenstruktur (dem Container "root"). Die Größe des Arrays wird von dwForwardSize angegeben.
dwTerminalModesSize
Größe des Terminalmodiarrays in Byte.
dwTerminalModesOffset
Offset vom Anfang der -Struktur zum variabel dimensionierten Gerätefeld, das ein Array mit Einträgen im DWORD-Format enthält, die mindestens eine der LINETERMMODE_ Konstanten verwenden. Dieses Array wird nach Terminalbezeichnern im Bereich von null bis eins kleiner als dwNumTerminals indiziert. Jeder Eintrag im Array gibt die aktuellen Terminalmodi für den entsprechenden Terminalsatz mit der lineSetTerminal-Funktion für diese Adresse an. Die Größe des Arrays wird von dwTerminalModesSize angegeben.
dwDevSpecificSize
Größe des gerätespezifischen Felds in Bytes.
dwDevSpecificOffset
Offset vom Anfang dieser Struktur zum variabel dimensionierten gerätespezifischen Feld. Die Größe des Felds wird von dwDevSpecificSize angegeben.
Hinweise
Gerätespezifische Erweiterungen sollten den DevSpecific-Bereich (dwDevSpecificSize und dwDevSpecificOffset) mit unterschiedlicher Größe dieser Datenstruktur verwenden.
Diese Datenstruktur wird von der lineGetAddressStatus-Funktion zurückgegeben. Wenn sich Elemente in dieser Datenstruktur aufgrund von Aktivitäten an der Adresse ändern, wird eine LINE_ADDRESSSTATE Nachricht an die Anwendung gesendet. Ein Parameter für diese Nachricht ist der Adresszustand, eine der LINEADDRESSSTATE_ Konstanten, die angibt, dass sich das status Element in diesem Datensatz geändert hat.
Anforderungen
Anforderung | Wert |
---|---|
Header | tapi.h |