lineAccept-Funktion (tapi.h)

Artikel
08/26/2023

Die lineAccept-Funktion akzeptiert den angegebenen angebotenen Aufruf. Optional kann er die angegebenen Benutzer-/Benutzerinformationen an die aufrufende Partei senden.

Syntax

LONG lineAccept(
  HCALL  hCall,
  LPCSTR lpsUserUserInfo,
  DWORD  dwSize
);

Parameter

hCall

Handle für den zu akzeptierenden Anruf. Die Anwendung muss ein Besitzer des Anrufs sein. Der Anrufstatus von hCall muss anbieten sein.

lpsUserUserInfo

Zeiger auf eine NULL-beendete Zeichenfolge, die Benutzer-/Benutzerinformationen enthält, die im Rahmen der Anrufannahme an die Remotepartei gesendet werden sollen. Dieser Zeiger kann NULL belassen, wenn keine Benutzer-/Benutzerinformationen gesendet werden sollen. Benutzer-/Benutzerinformationen werden nur gesendet, wenn sie vom zugrunde liegenden Netzwerk unterstützt werden (siehe LINEDEVCAPS). Das Protokoll-Diskriminatorelement für die Benutzer-/Benutzerinformationen sollte bei Bedarf als erstes Byte des Puffers angezeigt werden, auf den lpsUserUserInfo verweist, und muss in dwSize berücksichtigt werden.

dwSize

Größe der Benutzer-Benutzer-Informationen in lpsUserUserInfo (einschließlich des NULL-Abschlusszeichens ) in Bytes. Wenn lpsUserUserInfoNULL ist, werden keine Benutzer-/Benutzerinformationen an die aufrufende Seite gesendet, und dwSize wird ignoriert.

Rückgabewert

Gibt einen positiven Anforderungsbezeichner zurück, wenn die Funktion asynchron abgeschlossen wird, oder eine negative Fehlernummer, wenn ein Fehler auftritt. Der dwParam2-Parameter der entsprechenden LINE_REPLY Meldung ist null, wenn die Funktion erfolgreich ist, oder es ist eine negative Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:

LINEERR_INVALCALLHANDLE, LINEERR_INVALCALLSTATE, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_NOTOWNER, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED, LINEERR_USERUSERINFOTOOBIG.

Hinweise

Die lineAccept-Funktion wird in Telefonieumgebungen wie Integrated Services Digital Network (ISDN) verwendet, die es ermöglichen, warnungen im Zusammenhang mit eingehenden Anrufen vom anfänglichen Angebot des Anrufs zu trennen. Wenn ein Anruf eingeht, wird er zuerst angeboten. Für einen kurzen Zeitraum hat die Anwendung möglicherweise die Möglichkeit, den Anruf mithilfe von lineDrop abzulehnen, den Anruf mithilfe von lineRedirect an eine andere Station umzuleiten, den Anruf mit lineAnswer zu beantworten oder den Anruf mit lineAccept anzunehmen. Nachdem ein Anruf von einer Anwendung erfolgreich angenommen wurde, beginnt die Warnung sowohl beim aufgerufenen als auch beim aufrufenden Gerät, und der Anrufstatus wechselt in der Regel zu akzeptiert.

Warnungen werden der Anwendung von der LINE_LINEDEVSTATE Meldung mit der Klingelanzeige gemeldet.

Die lineAccept-Funktion kann auch von Nicht-ISDN-Dienstanbietern unterstützt werden. Der Anrufzustandsübergang zu "Akzeptiert" kann von anderen Anwendungen als Hinweis verwendet werden, dass eine andere Anwendung die Verantwortung für den Anruf übernommen und dem Benutzer den Anruf angezeigt hat.

Die Anwendung hat die Möglichkeit, Benutzer-/Benutzerinformationen zum Zeitpunkt der Annahme zu senden. Selbst wenn Benutzer- und Benutzerinformationen gesendet werden, gibt es keine Garantie, dass das Netzwerk diese Informationen an die aufrufende Partei übermittelt. Eine Anwendung sollte die Gerätefunktionen einer Leitung überprüfen, um zu ermitteln, ob die Anrufannahme verfügbar ist.