lineUnpark-Funktion (tapi.h)

Die lineUnpark-Funktion ruft den Anruf ab, der an der angegebenen Adresse geparkt ist, und gibt ein Aufrufhandle dafür zurück.

Syntax

LONG lineUnpark(
  HLINE   hLine,
  DWORD   dwAddressID,
  LPHCALL lphCall,
  LPCSTR  lpszDestAddress
);

Parameter

hLine

Handle an das Offene-Line-Gerät, auf dem ein Anruf entparkt werden soll.

dwAddressID

Adresse in hLine , an der der Unpark entstehen soll. Ein Adressbezeichner ist einer Adresse dauerhaft zugeordnet; Der Bezeichner bleibt über Betriebssystemupgrades hinweg konstant.

lphCall

Zeiger auf den Speicherort des Typs HCALL, an dem das Handle zum nicht geparkten Anruf zurückgegeben wird. Dieses Handle steht in keinem Zusammenhang mit einem anderen Handle, das dem abgerufenen Aufruf zuvor zugeordnet war, z. B. dem Handle, das dem Anruf beim ursprünglichen Parken zugeordnet wurde. Die Anwendung ist der anfängliche alleinige Besitzer dieses Aufrufs.

lpszDestAddress

Zeiger auf einen Zeichenpuffer mit NULL-Beendigung, der die Adresse enthält, an der der Aufruf geparkt wird. Die Adresse hat das standardmäßige wählbare Adressformat.

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_INVALADDRESS, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALADDRESSID, LINEERR_OPERATIONFAILED, LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM.

Anforderungen

Weitere Informationen

LINE_REPLY

Ergänzende Zeilendienstfunktionen

ÜBERSICHT ÜBER TAPI 2.2-Referenz