LINEADDRESSSTATUS-Struktur (tapi.h)

Artikel
08/26/2023

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.