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 linePark Funktion parkt den angegebenen Aufruf gemäß dem angegebenen Parkmodus.
Syntax
LONG lineParkA(
HCALL hCall,
DWORD dwParkMode,
LPCSTR lpszDirAddress,
LPVARSTRING lpNonDirAddress
);
Parameter
hCall
Behandeln Sie den Anruf, der geparkt werden soll. Die Anwendung muss ein Besitzer des Anrufs sein. Der Anrufstatus hCall- muss verbunden sein.
dwParkMode
Parkmodus, mit dem der Anruf geparkt werden soll. Dieser Parameter kann nur einen einzelnen Flagsatz aufweisen und verwendet eine der LINEPARKMODE_ Konstanten.
lpszDirAddress
Zeigen Sie auf eine NULL--terminated-Zeichenfolge, die die Adresse angibt, an der der Aufruf geparkt werden soll, wenn sie den gerichteten Park verwenden. Die Adresse ist im formatierbaren Nummernformat angegeben. Dieser Parameter wird für nicht gerichtetes Parken ignoriert.
lpNonDirAddress
Zeiger auf eine Struktur vom Typ VARSTRING-. Für den nicht direktgeleiteten Park wird die Adresse, an der der Anruf geparkt wird, in dieser Struktur zurückgegeben. Dieser Parameter wird für den gerichteten Park ignoriert. Innerhalb der VARSTRING- Struktur muss dwStringFormat- auf STRINGFORMAT_ASCII festgelegt werden (ein ASCII-Zeichenfolgenpuffer, der eine NULL--terminated-Zeichenfolge enthält), und die endende NULL- muss im dwStringSize-berücksichtigt werden. Vor dem Aufrufen linePark-muss die Anwendung die dwTotalSize Mitglied dieser Struktur festlegen, um die Menge des arbeitsspeicher verfügbaren TAPI für die Rückgabe von Informationen anzugeben.
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_NOTOWNER, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_INVALPARKMODE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.
Bemerkungen
Mit dem gerichteten Parken bestimmt die Anwendung die Adresse, an der der Anruf geparkt werden soll. Wenn der Schalter nicht direkt geparkt wird, bestimmt der Schalter die Adresse und stellt dies für die Anwendung bereit. In beiden Fällen kann ein geparkter Anruf durch Angabe dieser Adresse entparkt werden.
Der geparkte Anruf wechselt in der Regel in den Leerlaufzustand Zustand, nachdem er erfolgreich geparkt wurde, und die Anwendung sollte dann die Zuordnung zum Anruf abwickeln. Wenn die Anwendung eine lineUnpark- für den geparkten Anruf ausführt, wird für den nicht geparkten Anruf ein neuer Anrufhandle erstellt, auch wenn die Anwendung den alten Anrufhandle nicht verarbeitet hat.
Einige Schalter können den Benutzer erinnern, nachdem ein Anruf seit einiger Zeit geparkt wurde. Die Anwendung sieht eine , die Anruf mit einem Anrufgrund anbietet, der auf Erinnerungfestgelegt ist.
Wenn das dwTotalSize Member in der VARSTRING- Struktur keinen ausreichenden Speicher für den Empfang der Parkadresse angibt, gibt die entsprechende Antwortnachricht einen LINEERR_STRUCTURETOOSMALL Fehlerwert zurück. In solchen Fällen gibt es keine Möglichkeit, die vollständige Parkadresse abzurufen. Wenn ein LINEERR_STRUCTURETOOSMALL Fehlerwert zurückgegeben wird, enthält der dwNeededSize Member der NonDirAddress-Struktur keinen gültigen Wert. Wenn ein LINEERR_STRUCTURETOOSMALL Fehlerwert von einem nicht direkt ausgerichteten linePark-empfangen wird, erhöhen Sie die Größe des Puffers, und rufen Sie line Park erneut auf, bis sie entweder erfolgreich oder ein anderes LINEERR_XXX Ergebnis zurückgibt.
Anmerkung
Der header tapi.h definiert linePark 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 |