Freigeben über


ITAddressTranslation::TranslateDialog-Methode (tapi3if.h)

Die TranslateDialog-Methode zeigt ein anwendungsmodales Dialogfeld an, das es dem Benutzer ermöglicht, den aktuellen Speicherort einer Telefonnummer zu ändern, die gerade gewählt werden soll, den Standort anzupassen und Karte Parameter zu aufrufen und den Effekt anzuzeigen.

Syntax

HRESULT TranslateDialog(
  [in] TAPIHWND hwndOwner,
  [in] BSTR     pAddressIn
);

Parameter

[in] hwndOwner

Ein Handle an ein Fenster, an das das Dialogfeld angefügt werden soll. Kann ein NULL-Wert sein, der angibt, dass jedes während der Funktion erstellte Fenster kein Besitzerfenster haben darf.

[in] pAddressIn

Ein Zeiger auf BSTR , der eine Telefonnummer enthält, die verwendet wird, um die Auswirkungen der Änderungen des Benutzers auf die Standortparameter anzuzeigen. Die Zahl muss im kanonischen Format vorliegen. Dieser Zeiger kann NULL bleiben. In diesem Fall wird der Telefonnummernteil des Dialogfelds nicht angezeigt. Wenn der Parameter pAddressIn ein Unteradressen- oder Namensfeld oder zusätzliche Adressen enthält, die von der ersten Adresse durch ASCII CR- und LF-Zeichen getrennt sind, wird im Dialogfeld nur die erste Adresse verwendet.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
Methode war erfolgreich.
E_INVALIDARG
Der Parameter hwndOwner ist kein gültiges Handle, oder der Parameter pAddressIn ist keine gültige Telefonnummer.
E_POINTER
Der pAddressIn-Parameter ist kein gültiger Zeiger.
E_OUTOFMEMORY
Es ist nicht genügend Arbeitsspeicher vorhanden, um den Vorgang auszuführen.
E_UNEXPECTED
Ein unerwarteter Fehler ist aufgetreten.
TAPI_E_REGISTRY_SETTING_CORRUPT
Die Registrierungseinstellungen für die Adressübersetzung sind ungültig.
TAPI_E_NODRIVER
Es ist kein TSP vorhanden, der eine Übersetzung für diese Adresse durchführen kann.
TAPI_E_INUSE
Das Dialogfeld ist bereits geöffnet und wird verwendet.
TAPI_E_INVALADDRESS
Die aktuelle Adresse ist ungültig.
TAPI_E_OPERATIONFAILED
TAPI konnte den Vorgang nicht abschließen.

Hinweise

Die Anwendung muss SysAllocString verwenden, um Arbeitsspeicher für pAddressIn zuzuweisen, und SysFreeString muss den Arbeitsspeicher freigeben, wenn die Variable nicht mehr benötigt wird.

Die TranslateDialog-Methode ist ein COM-Wrapper für die LineTranslateDialog-Funktion TAPI 2.1.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile tapi3if.h (Tapi3.h einschließen)
Bibliothek Uuid.lib
DLL Tapi3.dll

Weitere Informationen

Address-Objekt

ITAddressTranslation

LineTranslateDialog