ITAddressTranslation::Metode TranslateAddress (tapi3if.h)

  • Artikel

Metode TranslateAddress membuat antarmuka informasi terjemahan alamat. Tujuan utama metode TranslateAddress adalah untuk mendapatkan string pDestAddress (alamat dapat dialable) yang diperlukan sebagai parameter untuk ITAddress::CreateCall. Metode TranslateAddress mengembalikan alamat dialable secara tidak langsung, sebagai salah satu properti objek ITAddressTranslationInfo .

Sintaks

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

Parameter

[in] pAddressToTranslate

Penunjuk ke BSTR yang berisi alamat yang memerlukan terjemahan.

[in] lCard

Kartu panggilan yang digunakan untuk terjemahan.

[in] lTranslateOptions

Indikator opsi terjemahan, lihat LINETRANSLATEOPTION__Constants.

[out] ppTranslated

Penunjuk ke antarmuka ITAddressTranslationInfo yang baru dibuat.

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai Makna
S_OK
 Metode berhasil.
E_POINTER
 Parameter ppTranslated bukan pointer yang valid.
E_OUTOFMEMORY
 Memori tidak cukup ada untuk melakukan operasi.
E_UNEXPECTED
 Metode gagal karena alasan yang tidak diketahui.
E_INVALIDARG
 Nilai lTranslateOptions tidak valid.
TAPI_E_NODRIVER
 Alamat ini tidak memiliki TSP yang terkait dengannya.
TAPI_E_REGISTRY_SETTING_CORRUPT
 Registri rusak.
TAPI_E_OPERATIONFAILED
 Metode gagal dengan TAPI.
TAPI_E_RESOURCEUNAVAIL
 TSP tidak tersedia.
TAPI_E_INVALCARD
 Nomor kartu tidak valid.

Keterangan

Aplikasi harus menggunakan SysAllocString untuk mengalokasikan memori untuk pAddressToTranslate dan menggunakan SysFreeString untuk membebaskan memori ketika variabel tidak lagi diperlukan.

Metode TranslateAddress adalah pembungkus COM untuk fungsi TAPI 2.1 LineTranslateAddress .

TAPI memanggil metode AddRef pada antarmuka ITAddressTranslationInfo yang dikembalikan oleh TranslateAddress. Aplikasi harus memanggil Rilis pada antarmuka ITAddressTranslationInfo ke sumber daya gratis yang terkait dengannya.

Persyaratan

Persyaratan Nilai
Target Platform Windows
Header tapi3if.h (termasuk Tapi3.h)
Pustaka Uuid.lib
DLL Tapi3.dll

Lihat juga

Objek Alamat

Alamat Dapat Dialable

ITAddressTranslation