Struktur LINETRANSLATEOUTPUT (tapi.h)

Struktur LINETRANSLATEOUTPUT menjelaskan hasil terjemahan alamat. Fungsi lineTranslateAddress menggunakan struktur ini.

Sintaks

typedef struct linetranslateoutput_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwDialableStringSize;
  DWORD dwDialableStringOffset;
  DWORD dwDisplayableStringSize;
  DWORD dwDisplayableStringOffset;
  DWORD dwCurrentCountry;
  DWORD dwDestCountry;
  DWORD dwTranslateResults;
} LINETRANSLATEOUTPUT, *LPLINETRANSLATEOUTPUT;

Anggota

dwTotalSize

Ukuran total yang dialokasikan untuk struktur data ini, dalam byte.

dwNeededSize

Ukuran yang diperlukan untuk struktur data ini untuk menyimpan semua informasi yang dikembalikan, dalam byte.

dwUsedSize

Ukuran bagian dari struktur data ini yang berisi informasi yang berguna, dalam byte.

dwDialableStringSize

Untai (karakter) yang dapat dialable ukuran, dalam byte, termasuk NULL yang mengakhiri.

dwDialableStringOffset

Offset dari awal struktur ini ke output yang diterjemahkan yang dapat diteruskan ke lineMakeCall, lineDial, atau fungsi lain yang memerlukan string yang dapat dialable. Output selalu string yang dihentikan null. Bidang tambahan seperti nama dan subaddress disertakan dalam string output ini jika berada dalam string input. String ini mungkin berisi informasi privat seperti nomor kartu panggilan. Ini tidak boleh ditampilkan kepada pengguna, untuk mencegah visibilitas yang tidak disengaja kepada orang yang tidak berwenang. Ukuran bidang ditentukan oleh dwDialableStringSize.

dwDisplayableStringSize

Ukuran output terjemahan yang dapat ditampilkan kepada pengguna, termasuk terminator null , dalam byte.

dwDisplayableStringOffset

Offset ke output terjemahan yang dapat ditampilkan kepada pengguna untuk konfirmasi. Ini identik dengan DialableString, kecuali digit kartu panggilan diganti dengan nama kartu yang ramah yang diapit dalam karakter tanda kurung siku (misalnya, "[AT&T Card]"), dan bidang tambahan seperti nama dan subaddress dihapus. Gunakan pesan yang sesuai di dwDisplayableStringOffset, karena string mungkin ditampilkan secara publik dalam kotak dialog status panggilan. Informasi ini juga sesuai untuk disertakan dalam log panggilan. Ukuran bidang ditentukan oleh dwDisplayableStringSize.

dwCurrentCountry

Kode negara atau wilayah dikonfigurasi dalam CurrentLocation. Nilai ini dapat digunakan untuk mengontrol tampilan oleh aplikasi elemen antarmuka pengguna tertentu, untuk deteksi nada kemajuan panggilan lokal, dan untuk tujuan lain.

dwDestCountry

Kode negara/wilayah tujuan dari alamat yang diterjemahkan. Nilai ini dapat diteruskan ke parameter dwCountryCodelineMakeCall dan fungsi panggilan lainnya (sehingga nada kemajuan panggilan negara/wilayah tujuan seperti sinyal sibuk terdeteksi dengan benar). Bidang ini diatur ke nol jika alamat tujuan yang diteruskan ke lineTranslateAddress tidak dalam format kanonis.

dwTranslateResults

Informasi yang berasal dari proses terjemahan, yang dapat membantu aplikasi dalam menyajikan elemen antarmuka pengguna. Bidang ini menggunakan salah satu konstanta LINETRANSLATERESULT_.

Keterangan

Struktur ini tidak dapat diperpanjang.

Persyaratan

Persyaratan	Nilai
Header	tapi.h

Lihat juga

lineDial

lineMakeCall

lineTranslateAddress