ITBasicCallControl::D ial-Methode (tapi3if.h)

Artikel
03/02/2024

Die Dial-Methode wählt die angegebene Adresse.

Syntax

HRESULT Dial(
  [in] BSTR pDestAddress
);

Parameter

[in] pDestAddress

Zeiger auf die BSTR-Darstellung der zu wählenden Adresse. Das Format muss einer wählbaren Standardadresse entsprechen.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	Bedeutung
S_OK	Methode war erfolgreich.
E_OUTOFMEMORY	Zum Ausführen des Vorgangs ist nicht genügend Arbeitsspeicher vorhanden.
E_POINTER	Der pDestAddress-Parameter ist kein gültiger Zeiger.
TAPI_E_TIMEOUT	Der Vorgang ist fehlgeschlagen, da die TAPI 3-DLL ein Timeout aufweist. Das Timeoutintervall beträgt zwei Minuten.

Hinweise

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

In einigen Fällen muss die Anwendung möglicherweise die Adressübersetzungsschnittstellen ( ITAddressTranslation und ITAddressTranslationInfo) verwenden, um eine pDestAddress-Zeichenfolge im richtigen Format abzurufen.

Die Dial-Methode unterscheidet sich von ITAddress::CreateCall dadurch, dass der Aufruf bereits vorhanden ist. Eine Beispielverwendung ist das Wählen einer Erweiterung.