lineGetNumRings-Funktion (tapi.h)
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.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Fenster |
| Header- | tapi.h |
| Library | Tapi32.lib |
| DLL- | Tapi32.dll |