lineCompleteCall-Funktion (tapi.h)

Artikel
08/26/2023

Die lineCompleteCall-Funktion gibt an, wie stattdessen ein Aufruf abgeschlossen werden soll, der nicht normal verbunden werden konnte. Das Netzwerk oder switch kann einen Anruf möglicherweise nicht abschließen, weil die Netzwerkressourcen ausgelastet sind oder die Remotestation ausgelastet ist oder nicht antwortet. Die Anwendung kann auf verschiedene Arten anfordern, dass der Aufruf abgeschlossen wird.

Syntax

LONG lineCompleteCall(
  HCALL   hCall,
  LPDWORD lpdwCompletionID,
  DWORD   dwCompletionMode,
  DWORD   dwMessageID
);

Parameter

hCall

Behandeln Sie den Aufruf, dessen Abschluss angefordert wird. Die Anwendung muss besitzer des Aufrufs sein. Der Anrufstatus von hCall muss ausgelastet oder ringback sein.

lpdwCompletionID

Zeiger auf einen Speicherspeicherort im DWORD-Format. Der Vervollständigungsbezeichner wird verwendet, um einzelne laufende Vervollständigungsanforderungen zu identifizieren. Ein Vervollständigungsbezeichner wird ungültig und kann wiederverwendet werden, nachdem die Anforderung abgeschlossen oder eine ausstehende Anforderung abgebrochen wurde.

dwCompletionMode

Art und Weise, in der der Aufruf abgeschlossen werden soll. Dieser Parameter verwendet nur eine der LINECALLCOMPLMODE_ Konstanten.

dwMessageID

Nachricht, die beim Abschluss des Anrufs mit LINECALLCOMPLMODE_MESSAGE gesendet werden soll. Dieser Bezeichner wählt die Nachricht aus einer kleinen Anzahl vordefinierter Nachrichten aus.

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_COMPLETIONOVERRUN, LINEERR_NOMEM, LINEERR_INVALCALLCOMPLMODE, LINEERR_NOTOWNER, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALMESSAGEID, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED.

Hinweise

Diese Funktion gilt als abgeschlossen, wenn die Anforderung vom Netzwerk oder Switch akzeptiert wurde; nicht, wenn die Anforderung in der angegebenen Weise vollständig abgeschlossen ist. Nach Abschluss dieser Funktion wechselt der Aufruf in der Regel in den Leerlauf. Wenn die aufgerufene Station oder das aufgerufene Netzwerk in einen Zustand wechselt, in dem der Anruf wie angefordert abgeschlossen werden kann, wird die Anwendung durch eine LINE_CALLSTATE Nachricht benachrichtigt, deren Anrufstatus gleich "Angebot" ist. Der LINECALLINFO-Eintrag des Aufrufs listet den Grund für den Anruf als CALLCOMPLETION auf und stellt auch den Vervollständigungsbezeichner bereit. Es ist möglich, mehrere ausstehende Anruferfüllungsanforderungen zu haben. die maximale Anzahl ist geräteabhängig. Der Vervollständigungsbezeichner wird auch verwendet, um auf jede einzelne Anforderung zu verweisen, sodass Anforderungen durch aufrufen von lineUncompleteCall abgebrochen werden können.