lineUnparkW-Funktion (tapi.h)

Die lineUnpark-Funktion ruft den Aufruf ab, der an der angegebenen Adresse geparkt wurde, und gibt dafür einen Anrufhandle zurück.

Syntax

LONG lineUnparkW(
  HLINE   hLine,
  DWORD   dwAddressID,
  LPHCALL lphCall,
  LPCWSTR lpszDestAddress
);

Parameter

hLine

Behandeln Sie das Offene Leitungsgerät, auf dem ein Anruf entparkt werden soll.

dwAddressID

Adresse auf hLine-, an der der Unpark entsteht. Ein Adressbezeichner ist dauerhaft einer Adresse zugeordnet; der Bezeichner bleibt für Betriebssystemupgrades konstant.

lphCall

Zeiger auf die Position des Typs HCALL, an der der Handle für den nicht geparkten Anruf zurückgegeben wird. Dieses Handle ist nicht mit einem anderen Handle verknüpft, das möglicherweise zuvor mit dem abgerufenen Aufruf verknüpft war, z. B. dem Handle, der dem Anruf zugeordnet sein könnte, als er ursprünglich geparkt wurde. Die Anwendung ist der erste alleinige Besitzer dieses Aufrufs.

lpszDestAddress

Zeigen Sie auf einen Null-beendeten Zeichenpuffer, der die Adresse enthält, an der der Aufruf geparkt wird. Die Adresse ist im standardwählbaren Adressformat enthalten.

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 Nachricht ist null, wenn die Funktion erfolgreich ist oder eine negative Fehlernummer ist, 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.

Bemerkungen

Anmerkung

Der header tapi.h definiert lineUnpark als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
Zielplattform- Fenster
Header- tapi.h
Library Tapi32.lib
DLL- Tapi32.dll

Siehe auch

LINE_REPLY

Ergänzende Line-Service-Funktionen

TAPI 2.2 Referenzübersicht