lineGetNumRings-Funktion (tapi.h)

Artikel
07/16/2024

Die lineGetNumRings--Funktion bestimmt, wie viele Anrufe an der angegebenen Adresse vor der Entgegennahme des Anrufs angerufen werden sollen.

Syntax

LONG lineGetNumRings(
  HLINE   hLine,
  DWORD   dwAddressID,
  LPDWORD lpdwNumRings
);

Parameter

hLine

Behandeln des offenen Leitungsgeräts.

dwAddressID

Adresse auf dem Leitungsgerät. Ein Adressbezeichner ist dauerhaft einer Adresse zugeordnet; der Bezeichner bleibt für Betriebssystemupgrades konstant.

lpdwNumRings

Die Anzahl der Ringe, die das Minimum aller aktuellen lineSetNumRings Anforderungen darstellt.

Rückgabewert

Gibt Null zurück, wenn die Anforderung erfolgreich ist oder eine negative Fehlernummer auftritt, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:

LINEERR_INVALADDRESSID, LINEERR_OPERATIONFAILED, LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM.

Bemerkungen

Die lineGetNumRings und lineSetNumRings Funktionen, wenn sie in Kombination verwendet werden, bieten einen Mechanismus zur Unterstützung der Implementierung von Features für gebührenpflichtige Speicherprogramme in mehreren unabhängigen Anwendungen.

Eine Anwendung, die ein Handle für einen Anruf im bietet Zustand und eine LINE_LINEDEVSTATEKlingeln Nachricht sollte eine Anzahl von Ringen, die von lineGetNumRings zurückgegeben werden, warten, bevor Sie den Anruf annehmen, um die Einstellungen für die gebührenpflichtige Speicherung in allen Anwendungen zu berücksichtigen. Die lineGetNumRings--Funktion gibt das Minimum der Anzahl der Durch lineSetNumRingsangegebenen Ringe aller Anwendungen zurück. Da diese Nummer dynamisch variieren kann, sollte eine Anwendung lineGetNumRings jedes Mal aufrufen, wenn sie die Möglichkeit hat, einen Anruf zu beantworten. Wenn keine Anwendung lineSetNumRings-aufgerufen hat, wird die Anzahl der zurückgegebenen Ringe 0xFFFFFFFF. Eine separate LINE_LINEDEVSTATE Klingeln Nachricht wird für jeden Ringzyklus an die Anwendung gesendet.

Wenn die Anrufklassifizierung von TAPI durchgeführt wird, um alle Anrufe des unbekannten Medienmodus zu beantworten und den Mediendatenstrom zu filtern, berücksichtigt TAPI auch diese Nummer.

Hinweis Dieser Vorgang ist rein informativ und wirkt sich nicht selbst auf den Zustand von Anrufen auf dem Leitungsgerät aus.