ITAddressTranslation::TranslateAddress-Methode (tapi3if.h)

Artikel
03/02/2024

Die TranslateAddress-Methode erstellt die Schnittstelle zur Adressübersetzungsinformation. Das primäre Ziel der TranslateAddress-Methode besteht darin, die pDestAddress-Zeichenfolge (wählbare Adresse) abzurufen, die als Parameter für ITAddress::CreateCall benötigt wird. Die TranslateAddress-Methode gibt die wählbare Adresse indirekt als eine der Eigenschaften eines ITAddressTranslationInfo-Objekts zurück.

Syntax

HRESULT TranslateAddress(
  [in]  BSTR                     pAddressToTranslate,
  [in]  long                     lCard,
  [in]  long                     lTranslateOptions,
  [out] ITAddressTranslationInfo **ppTranslated
);

Parameter

[in] pAddressToTranslate

Zeiger auf BSTR , der die Adresse enthält, die eine Übersetzung erfordert.

[in] lCard

Aufrufen Karte für die Übersetzung verwendet.

[in] lTranslateOptions

Indikator für Übersetzungsoptionen finden Sie unter LINETRANSLATEOPTION__Constants.

[out] ppTranslated

Zeiger auf die neu erstellte ITAddressTranslationInfo-Schnittstelle .

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	Bedeutung
S_OK	Methode war erfolgreich.
E_POINTER	Der ppTranslated-Parameter ist kein gültiger Zeiger.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher vorhanden, um den Vorgang auszuführen.
E_UNEXPECTED	Die Methode ist aus unbekannten Gründen fehlgeschlagen.
E_INVALIDARG	Der lTranslateOptions-Wert ist ungültig.
TAPI_E_NODRIVER	Dieser Adresse ist kein TSP zugeordnet.
TAPI_E_REGISTRY_SETTING_CORRUPT	Die Registrierung ist beschädigt.
TAPI_E_OPERATIONFAILED	Fehler bei der Methode mit TAPI.
TAPI_E_RESOURCEUNAVAIL	Der TSP ist nicht verfügbar.
TAPI_E_INVALCARD	Die Karte Nummer ist ungültig.

Hinweise

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

Die TranslateAddress-Methode ist ein COM-Wrapper für die TAPI 2.1 LineTranslateAddress-Funktion .

TAPI ruft die AddRef-Methode für die VON TranslateAddressZurückgegebene ITAddressTranslationInfo-Schnittstelle auf. Die Anwendung muss Release auf der ITAddressTranslationInfo-Schnittstelle aufrufen, um zugeordnete Ressourcen freizugeben.