TSPI_lineAccept-Funktion (tspi.h)
Die TSPI_lineAccept-Funktion akzeptiert den angegebenen angebotenen Aufruf. Optional kann er die angegebenen Benutzer-/Benutzerinformationen an die aufrufende Partei senden.
Syntax
LONG TSPIAPI TSPI_lineAccept(
DRV_REQUESTID dwRequestID,
HDRVCALL hdCall,
LPCSTR lpsUserUserInfo,
DWORD dwSize
);
Parameter
dwRequestID
Der Bezeichner der asynchronen Anforderung.
hdCall
Das Handle für den zu akzeptierenden Anruf. Der Anrufstatus von hdCall kann angeboten werden.
lpsUserUserInfo
Ein Zeiger auf eine unicode-Zeichenfolge mit Null-Beendigung, die Benutzer-Benutzer-Informationen enthält, die im Rahmen der Aufrufannahme an die Remotepartei gesendet werden sollen. Dieser Zeiger ist NULL , wenn keine Benutzer-/Benutzerinformationen gesendet werden sollen. Benutzer-/Benutzerinformationen werden nur gesendet, wenn sie vom zugrunde liegenden Netzwerk unterstützt werden (siehe LINEDEVCAPS).
dwSize
Die Größe der Benutzer-Benutzer-Informationen in lpsUserUserInfo in Byte. Wenn lpsUserUserInfoNULL ist, wird dwSize ignoriert.
Rückgabewert
Gibt dwRequestID zurück, wenn die Funktion asynchron abgeschlossen wird, oder eine Fehlernummer, wenn ein Fehler auftritt. Der lResult-Parameter des entsprechenden ASYNC_COMPLETION ist null, wenn die Funktion erfolgreich ist, oder eine Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:
LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_USERUSERINFOTOOBIG, LINEERR_OPERATIONUNAVAIL.
Hinweise
Die funktion TSPI_lineAccept wird in Telefonieumgebungen (z. B. ISDN) verwendet, die es ermöglichen, warnungen im Zusammenhang mit eingehenden Anrufen vom ursprünglichen Angebot des Anrufs zu trennen. Wenn ein Anruf eingeht, wird der Anruf zuerst angeboten. Für eine kurze Zeit hat die Clientanwendung möglicherweise die Möglichkeit, den Anruf mit TSPI_lineDrop abzulehnen, den Anruf mithilfe von TSPI_lineRedirect an eine andere Station umzuleiten, den Anruf mit TSPI_lineAnswer anzunehmen oder den Anruf mithilfe von TSPI_lineAccept anzunehmen. Nachdem ein Anruf erfolgreich angenommen wurde, beginnt die Warnung sowohl beim aufgerufenen als auch beim aufrufenden Gerät, und in der Regel wechselt der Anrufzustand in den akzeptierten Zustand. Der Dienstanbieter muss das Flag LINEADDRCAPFLAGS_ACCEPTTOALERT im dwAddrCapFlags-Member der LINEADDRESSCAPS-Datenstruktur festlegen, wenn die Anwendung TSPI_lineAccept aufrufen muss, damit die Warnung gestartet wird.
An TAPI werden Warnungen mithilfe der LINE_LINEDEVSTATE Meldung mit der Klingelanzeige gemeldet.
TSPI_lineAccept können auch von Nicht-ISDN-Dienstanbietern unterstützt werden. Der Übergang des Anrufzustands in den akzeptierten Zustand kann von anderen TAPI-Clients als Hinweis verwendet werden, dass eine Anwendung die Verantwortung für den Anruf übernommen und den Anruf an den Benutzer übergeben hat.
Die Clientanwendung hat die Möglichkeit, Benutzer-/Benutzerinformationen zum Zeitpunkt der Annahme zu senden. Selbst wenn Benutzer- und Benutzerinformationen gesendet werden können, wird oft nicht garantiert, dass das Netzwerk diese Informationen an die aufrufende Partei übermittelt. Die Clientanwendung kann die Gerätefunktionen einer Leitung überprüfen, um zu ermitteln, ob die Anrufannahme verfügbar ist.
Anforderungen
Zielplattform | Windows |
Kopfzeile | tspi.h |