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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk