ITBasicCallControl::D ial-Methode (tapi3if.h)
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 |
|---|---|
|
Methode war erfolgreich. |
|
Zum Ausführen des Vorgangs ist nicht genügend Arbeitsspeicher vorhanden. |
|
Der pDestAddress-Parameter ist kein gültiger Zeiger. |
|
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.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tapi3if.h (einschließlich Tapi3.h) |
| Bibliothek | Uuid.lib |
| DLL | Tapi3.dll |