ITAddressTranslation::TranslateDialog-Methode (tapi3if.h)

Artikel
03/02/2024

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.