Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die lineDial--Funktion wählt die angegebene einwählbare Nummer für den angegebenen Anruf.
Syntax
LONG lineDialW(
HCALL hCall,
LPCWSTR lpszDestAddress,
DWORD dwCountryCode
);
Parameter
hCall
Behandeln Sie den Anruf, an dem eine Nummer gewählt werden soll. Die Anwendung muss ein Besitzer des Anrufs sein. Der Anrufstatus hCall- kann ein beliebiger Zustand sein, außer leerlauf und getrennten.
lpszDestAddress
Ziel, das mit dem standardwählbaren Nummernformat gewählt werden soll.
dwCountryCode
Code für Land oder Region des Ziels. Dies wird von der Implementierung verwendet, um die Anrufstatusprotokolle für die Zieladresse auszuwählen. Wenn ein Wert von 0 angegeben wird, wird ein vom Dienstanbieter definiertes Standardanrufstatusprotokoll verwendet.
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_ADDRESSBLOCKED, LINEERR_INVALPOINTER, LINEERR_DIALBILLING, LINEERR_NOMEM, LINEERR_DIALDIALTONE, LINEERR_NOTOWNER, LINEERR_DIALPROMPT, LINEERR_OPERATIONFAILED, LINEERR_DIALQUIET, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_UNINITIALIZED, LINEERR_INVALCOUNTRYCODE.
Bemerkungen
Wenn LINEERR_INVALADDRESS zurückgegeben wird, wurde keine Wählverbindung durchgeführt. Wenn LINEERR_DIALBILLING, LINEERR_DIALQUIET, LINEERR_DIALDIALTONE oder LINEERR_DIALPROMPT zurückgegeben werden, sind keine aktionen aufgetreten, die andernfalls von lineDial- ausgeführt werden. Beispielsweise wurde keine der einwählbaren Adressen vor dem betreffenden Zeichen gewählt, es wurde kein Hookswitchzustand geändert usw.
Die lineDial--Funktion wird für die Einwahl in einer vorhandenen Anrufdarstellung verwendet. Wenn beispielsweise ein Anruf für die Übertragung oder Konferenz eingerichtet wurde, wird automatisch ein Konsultationsgespräch zugewiesen, und die lineDial--Funktion wird verwendet, um die Einwahl dieses Konsultationsanrufs durchzuführen. Die lineDial--Funktion kann im Laufe der mehrstufigen Wählfunktion mehrmals aufgerufen werden, wenn die Gerätefunktionen der Linie dies zulassen. Außerdem können mehrere Adressen in einer einzelnen durch CRLF getrennten Wählzeichenfolge bereitgestellt werden. Dienstanbieter, die umgekehrte Multiplexing bereitstellen, können einzelne physische Anrufe mit jedem der Adressen herstellen und ein einzelnes Anrufhandle an das Aggregat aller Aufrufe der Anwendung zurückgeben. Alle Adressen würden denselben Landes- oder Regionscode verwenden.
Die Wählhilfe gilt als vollständig, nachdem die Adresse an den Dienstanbieter übergeben wurde; nicht nach der endgültigen Verbindung des Anrufs. Dienstanbieter, die umgekehrte Multiplexing bereitstellen, können die Bereitstellung mehrerer Adressen gleichzeitig ermöglichen. Der Dienstanbieter sendet LINE_CALLSTATE Nachrichten an die Anwendung, um ihn über den Fortschritt des Anrufs zu informieren. Um einen Anrufversuch abzubrechen, während ein Anruf eingerichtet wird, sollte die aufrufende Anwendung lineDrop-verwenden.
Eine Anwendung kann den lpszDestAddress Parameter der funktion lineDial auf die Adresse einer leeren Zeichenfolge festlegen, um anzugeben, dass die Wählfunktion abgeschlossen ist. aber nur, wenn die vorherigen Aufrufe der lineMakeCall- und lineDial--Funktionen die Zeichenfolgen aufweisen, die durch lpszDestAddress mit Semikolons beendet wurden.
Die lineDial--Funktion kann auch bei teilweiser Wählfunktion verwendet werden. Um einen Anruf mit teilweiser Wählverbindung zu initiieren, ruft die Anwendung lineMakeCall auf und gibt eine teilweise Wählzeichenfolge an. Eine partielle Wählzeichenfolge ist eine beliebige Wählzeichenfolge, die durch ein Semikolon beendet wird. Der Aufruf wechselt in der Regel zu LINECALLSTATE_DIALING, nach der lineDial- aufgerufen werden kann, um weitere Wählzeichenfolgen anzugeben, die jeweils durch ein Semikolon beendet werden. Die Wählfunktion wird abgeschlossen, indem lineDial- mit einer Wählzeichenfolge aufgerufen wird, die nicht mit einem Semikolon (z. B. einer leeren Zeichenfolge) beendet wird. Mit dieser Technik können Anwendungen interaktive partielle Wählvorgänge mit dem Benutzer durchführen oder komplexere Wählvorgänge aktivieren, als ein TSP möglicherweise möglich ist.
Wenn eine NULL-Zielzeichenfolge oder eine leere Zeichenfolge, die mit einem Semikolon (";") beendet wird, in lineMakeCall die Anwendung in LINE_CALLSTATE_DIALTONE übergibt. Die funktion lineDial kann in diesem Zustand aufgerufen werden, um eine einzelne Wählzeichenfolge oder mehrere teilweise Wählzeichenfolgen einzugeben, die jeweils durch ein Semikolon getrennt sind. Die Anwendung wechselt in den zustand LINECALLSTATE_DIALING, nachdem die erste Ziffer eingegeben wurde.
Hinweis Die funktion lineDial- ist nur verfügbar, wenn sich ein Aufruf in LINECALLSTATE_DIALING oder LINE_CALLSTATE_DIALTONE befindet. Wenn DTMF benötigt wird, während ein Anruf verbunden ist (LINECALLSTATE_CONNECTED), verwenden Sie lineGenerateDigits.
Anmerkung
Der header tapi.h definiert lineDial als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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 |