ITAddressTranslation::TranslateDialog method (tapi3if.h)

Artikel
03/02/2024

Metode TranslateDialog menampilkan kotak dialog modal aplikasi yang memungkinkan pengguna untuk mengubah lokasi nomor telepon saat ini yang akan dihubungi, menyesuaikan parameter lokasi dan kartu panggilan, dan melihat efeknya.

Sintaks

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

Parameter

[in] hwndOwner

Handel ke jendela tempat kotak dialog akan dilampirkan. Dapat berupa nilai NULL untuk menunjukkan bahwa setiap jendela yang dibuat selama fungsi seharusnya tidak memiliki jendela pemilik.

[in] pAddressIn

Pointer ke BSTR yang berisi nomor telepon yang digunakan untuk menunjukkan efek perubahan pengguna pada parameter lokasi. Angka harus dalam format kanonis. Penunjuk ini dapat dibiarkan NULL, dalam hal ini bagian nomor telepon dari kotak dialog tidak ditampilkan. Jika parameter pAddressIn berisi subaddress atau bidang nama atau alamat tambahan yang dipisahkan dari alamat pertama oleh karakter ASCII CR dan LF, hanya alamat pertama yang digunakan dalam kotak dialog.

Mengembalikan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
E_INVALIDARG	Parameter hwndOwner bukan handel yang valid atau parameter pAddressIn bukan nomor telepon yang valid.
E_POINTER	Parameter pAddressIn bukan penunjuk yang valid.
E_OUTOFMEMORY	Memori tidak cukup ada untuk melakukan operasi.
E_UNEXPECTED	Terjadi kesalahan tak terduga.
TAPI_E_REGISTRY_SETTING_CORRUPT	Pengaturan registri untuk terjemahan alamat tidak valid.
TAPI_E_NODRIVER	Tidak ada TSP yang dapat melakukan terjemahan untuk alamat ini.
TAPI_E_INUSE	Dialog sudah terbuka dan sedang digunakan.
TAPI_E_INVALADDRESS	Alamat saat ini tidak valid.
TAPI_E_OPERATIONFAILED	TAPI tidak dapat menyelesaikan operasi.

Keterangan

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

Metode TranslateDialog adalah pembungkus COM untuk fungsi TAPI 2.1 LineTranslateDialog .