TSPI_lineUnpark Funktion (tspi.h)
Die funktion TSPI_lineUnpark ruft den Aufruf ab, der an der angegebenen Adresse geparkt ist, und gibt einen Anrufpunkt dafür zurück.
Syntax
LONG TSPIAPI TSPI_lineUnpark(
DRV_REQUESTID dwRequestID,
HDRVLINE hdLine,
DWORD dwAddressID,
HTAPICALL htCall,
LPHDRVCALL lphdCall,
LPCWSTR lpszDestAddress
);
Parameter
dwRequestID
Der Bezeichner der asynchronen Anforderung.
hdLine
Der Handle an die Zeile, auf der ein Anruf nicht geparkt werden soll.
dwAddressID
Die Adresse auf hdLine , an der der Unpark entsteht. Ein Adressbezeichner ist dauerhaft einer Adresse zugeordnet; der Bezeichner bleibt in allen Betriebssystemupgrades konstant. TAPI überprüft diesen Parameter nicht, wenn diese Funktion aufgerufen wird.
htCall
Der TAPI-Handle zum neuen nicht geparkten Anruf. Der Dienstanbieter muss dies speichern und in allen nachfolgenden Aufrufen der LINEEVENT-Prozedur verwenden, die Ereignisse für den Aufruf meldet.
lphdCall
Ein Zeiger auf einen HDRVCALL , der den Bezeichner des Dienstanbieters für den neuen unparkten Aufruf darstellt. Der Dienstanbieter muss diesen Speicherort mit seinem Handle für den Aufruf ausfüllen, bevor diese Prozedur zurückgegeben wird. Dieses Handle ist ungültig, wenn die Funktion zu einem Fehler führt.
lpszDestAddress
Ein Zeiger auf eine mit Null beendete Unicode-Zeichenfolge, die die Adresse enthält, an der der Aufruf geparkt wird. Die Adresse befindet sich im einwählbaren Adressformat.
Rückgabewert
Gibt dwRequestID oder eine Fehlernummer zurück, wenn ein Fehler auftritt. Der tatsächliche lResult-Parameter der entsprechenden ASYNC_COMPLETION ist null, wenn die Funktion erfolgreich ist, oder eine Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind wie folgt:
LINEERR_INVALLINEHANDLE, LINEERR_NOMEM, LINEERR_INVALPOINTER, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALADDRESSID, LINEERR_OPERATIONFAILED, LINEERR_INVALADDRESS, LINEERR_RESOURCEUNAVAIL.
Bemerkungen
Diese Funktion unterscheidet sich von der entsprechenden TAPI-Funktion darin, dass sie dem TSPI-Modell folgt, um die Lebensdauer eines Aufrufs zu beginnen. TAPI und der Dienstanbieter tauschen undurchsichtige Handle aus, die den Anruf miteinander darstellen. Darüber hinaus ist es dem Dienstanbieter gestattet, Rückrufe für den neuen Aufruf auszuführen, bevor er von dieser Prozedur zurückgibt. In jedem Fall muss der Dienstanbieter auch den handle behandeln, der als "noch gültig" zurückgegeben wurde, bis nach dem übereinstimmenden ASYNC_COMPLETION Nachrichtenerfolg gemeldet wurde. Mit anderen Worten, es darf keine LINEEVENT-Nachrichten für den neuen Anruf ausgeben oder in Anrufanzahlen in Nachrichten oder Statusdatenstrukturen für die Zeile einschließen.
Der von dieser Funktion erstellte Anrufpunkt ist ein neuer, eindeutiger, Anrufpunkt, auch wenn ein ursprünglicher Anrufpunkt für den Anruf noch vorhanden ist (es wurde nicht durch TSPI_lineCloseCall zerstört).
Requirements (Anforderungen)
| Zielplattform | Windows |
| Kopfzeile | tspi.h |