lineAnswer-Funktion (tapi.h)

Artikel
08/26/2023

Die funktion lineAnswer beantwortet den angegebenen Angebotsaufruf.

Syntax

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

Parameter

hCall

Behandeln Sie den Anruf, der beantwortet werden soll. Die Anwendung muss besitzer dieses Aufrufs sein. Der Anrufstatus von hCall muss anbieten oder akzeptiert sein.

lpsUserUserInfo

Zeiger auf eine null-beendete Zeichenfolge, die Benutzer-Benutzer-Informationen enthält, die zum Zeitpunkt der Anrufbeantwortung an die Remotepartei gesendet werden sollen. Dieser Zeiger kann NULL belassen werden, wenn keine Benutzerinformationen gesendet werden sollen. Benutzerinformationen werden nur gesendet, wenn sie vom zugrunde liegenden Netzwerk unterstützt werden (siehe LINEDEVCAPS). Das Protokolldiskriminatorfeld für die Benutzer-Benutzer-Informationen sollte bei Bedarf als erstes Byte des Puffers angezeigt werden, auf den von lpsUserUserInfo verwiesen wird, und muss in dwSize berücksichtigt werden.

dwSize

Größe der Benutzer-Benutzer-Informationen in lpsUserUserInfo (einschließlich des NULL-Abschlussators ) in Bytes Wenn lpsUserUserInfoNULL ist, werden keine Benutzer-Benutzer-Informationen an die aufrufende Partei 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 0, wenn die Funktion erfolgreich ist, oder es ist eine negative Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:

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

Hinweise

Wenn ein neuer Anruf eingeht, erhalten Anwendungen mit Interesse an dem Anruf eine LINE_CALLSTATE Nachricht, um den neuen Anrufhandle bereitzustellen und die Anwendung über den Status des Anrufs und die Berechtigungen für den neuen Anruf (z. B. Monitor oder Besitzer) zu informieren. Die Anwendung mit besitzerrechten für den Anruf kann diesen Anruf mit lineAnswer beantworten. Nachdem der Anruf erfolgreich beantwortet wurde, wechselt der Anruf in der Regel in den Verbundenen Zustand. Zunächst erhält nur eine Anwendung Besitzerberechtigungen für den eingehenden Aufruf.

In einigen Telefonieumgebungen (z. B. ISDN), in denen Benutzerwarnungen vom Anrufangebot getrennt sind, kann die Anwendung die Möglichkeit haben, einen Anruf vor der Antwort anzunehmen oder den Angebotsanruf abzulehnen oder umzuleiten.

Wenn ein Anruf zu dem Zeitpunkt eingeht (angeboten wird), zu dem ein anderer Aufruf bereits aktiv ist, stellt beim Aufrufen von lineAnswer eine Verbindung mit dem neuen Anruf her. Welche Auswirkungen dies auf den vorhandenen aktiven Aufruf hat, hängt von den Gerätefunktionen der Leitung ab. Der erste Anruf kann nicht betroffen sein, er kann automatisch gelöscht oder automatisch in der Warteschleife platziert werden. Die entsprechenden LINE_CALLSTATE Nachrichten melden Zustandsübergänge zu beiden Aufrufen an die Anwendung.

Wenn in einer Bridgesituation ein Aufruf verbunden ist, sich aber im zustand LINECONNECTEDMODE_INACTIVE befindet, kann er mithilfe der lineAnswer-Funktion verknüpft werden.

Die Anwendung hat die Möglichkeit, Benutzerinformationen zum Zeitpunkt der Antwort zu senden. Selbst wenn Benutzerinformationen gesendet werden können, gibt es keine Garantie, dass das Netzwerk diese Informationen an die aufrufende Partei übermittelt. Eine Anwendung sollte die Gerätefunktionen einer Leitung konsultieren, um zu ermitteln, ob das Senden von Benutzer-Benutzer-Informationen bei der Anrufbeantwortung verfügbar ist.