ITBasicCallControl::P arkDirect-Methode (tapi3if.h)

Artikel
08/26/2023

Die ParkDirect-Methode parkt den Aufruf an einer angegebenen Adresse.

Syntax

HRESULT ParkDirect(
  [in] BSTR pParkAddress
);

Parameter

[in] pParkAddress

Zeiger auf BSTR mit der Adresse, an der der Anruf geparkt werden soll.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Methode war erfolgreich.
E_POINTER	Der pParkAddress-Parameter ist kein gültiger Zeiger.
E_FAIL	Park wird nicht unterstützt.
E_INVALIDARG	Der pParkAddress-Parameter ist ungültig.
E_OUTOFMEMORY	Zum Ausführen des Vorgangs ist nicht genügend Arbeitsspeicher vorhanden.
TAPI_E_TIMEOUT	Der Vorgang ist fehlgeschlagen, da die TAPI 3-DLL ein Timeout aufweist. Das Timeoutintervall beträgt zwei Minuten.

Hinweise

Einige Dienstanbieter unterstützen diesen Vorgang nicht, während das Streaming aktiv ist. Die Anwendung muss möglicherweise ITStream::StopStream oder ITSubStream::StopSubStream vor dem Vorgang und ITStream::StartStream oder ITSubStream::StartSubStream nach Abschluss des Vorgangs aufrufen.

Beim gerichteten Parken bestimmt die Anwendung die Adresse, an der sie den Anruf parken möchte. Bei ParkInDirect bestimmt der Switch die Adresse und stellt diese der Anwendung zur Verfügung. In beiden Fällen kann ein geparkter Anruf aufgehoben werden, indem Sie diese Adresse angeben.

Der geparkte Anruf wechselt in den Status "Getrennt", nachdem er erfolgreich geparkt wurde.

Einige Schalter können den Benutzer daran erinnern, nachdem ein Anruf längere Zeit geparkt wurde. Die Anwendung sieht einen Angebotsanruf, bei dem die Anrufursache auf Erinnerung festgelegt ist.

Die Anwendung muss SysAllocString verwenden, um Arbeitsspeicher für den pParkAddress-Parameter zuzuweisen und SysFreeString zum Freigeben des Arbeitsspeichers verwenden, wenn die Variable nicht mehr benötigt wird.