Struktur LINELOCATIONENTRY (tapi.h)

Artikel
03/08/2023

Struktur LINELOCATIONENTRY menjelaskan lokasi yang digunakan untuk memberikan konteks terjemahan alamat. Struktur LINETRANSLATECAPS dapat berisi array struktur LINELOCATIONENTRY .

Sintaks

typedef struct linelocationentry_tag {
  DWORD dwPermanentLocationID;
  DWORD dwLocationNameSize;
  DWORD dwLocationNameOffset;
  DWORD dwCountryCode;
  DWORD dwCityCodeSize;
  DWORD dwCityCodeOffset;
  DWORD dwPreferredCardID;
  DWORD dwLocalAccessCodeSize;
  DWORD dwLocalAccessCodeOffset;
  DWORD dwLongDistanceAccessCodeSize;
  DWORD dwLongDistanceAccessCodeOffset;
  DWORD dwTollPrefixListSize;
  DWORD dwTollPrefixListOffset;
  DWORD dwCountryID;
  DWORD dwOptions;
  DWORD dwCancelCallWaitingSize;
  DWORD dwCancelCallWaitingOffset;
} LINELOCATIONENTRY, *LPLINELOCATIONENTRY;

Anggota

dwPermanentLocationID

Permanen. Mengidentifikasi lokasi.

dwLocationNameSize

Ukuran, dalam karakter, dari string nama lokasi yang dihentikan null termasuk karakter null-terminating.

dwLocationNameOffset

Ukuran offset, ditentukan dalam dwLocationNameSize, dari awal struktur LINETRANSLATECAPS (yang berisi entri ini) ke string yang dihentikan null yang menjelaskan lokasi dengan cara yang mudah digunakan.

dwCountryCode

Kode negara atau wilayah lokasi.

dwCityCodeSize

Ukuran, dalam karakter, dari string kode kota yang dihentikan null, termasuk karakter null-terminating.

dwCityCodeOffset

Offset, ditentukan dalam dwCityCodeSize, dari awal struktur ini hingga string yang dihentikan null yang menentukan kode kota/area yang terkait dengan lokasi. Informasi ini, dengan kode negara atau wilayah, dapat digunakan oleh aplikasi untuk "default" bidang entri untuk pengguna saat memasukkan nomor telepon, untuk mendorong entri nomor kanonis yang tepat.

dwPreferredCardID

Kartu panggil pilihan ketika memutar nomor dari lokasi ini.

dwLocalAccessCodeSize

Ukuran, dalam byte, dari string kode akses lokal, termasuk terminator null .

dwLocalAccessCodeOffset

Ukuran offset, ditentukan dalam dwLocalAccessCodeSize, dari awal struktur LINETRANSLATECAPS hingga string yang dihentikan null yang berisi kode akses yang akan dihubungi sebelum panggilan ke alamat di area panggilan lokal.

dwLongDistanceAccessCodeSize

Ukuran, dalam byte, dari kode akses jarak jauh, termasuk terminator null .

dwLongDistanceAccessCodeOffset

Ukuran offset, ditentukan dalam dwLongDistanceAccessCodeSize, dari awal struktur LINETRANSLATECAPS hingga string yang dihentikan null yang berisi kode akses yang akan dihubungi sebelum panggilan ke alamat di luar area panggilan lokal.

dwTollPrefixListSize

Ukuran, dalam byte, dari awalan tol, termasuk terminator null .

dwTollPrefixListOffset

Ukuran offset, ditentukan dalam dwTollPrefixListSize, dari awal struktur LINETRANSLATECAPS hingga string null-terminated yang berisi daftar awalan tol untuk lokasi tersebut. String hanya berisi awalan yang terdiri dari digit "0" hingga "9", dipisahkan satu sama lain oleh satu karakter "," (koma).

dwCountryID

Pengidentifikasi negara/wilayah yang dipilih untuk lokasi tersebut. Ini dapat digunakan dengan fungsi lineGetCountry untuk mendapatkan informasi tambahan tentang negara/wilayah tertentu, seperti nama negara/wilayah (anggota dwCountryCode tidak dapat digunakan untuk tujuan ini karena kode negara/wilayah tidak unik).

dwOptions

Opsi yang berlaku untuk lokasi ini, dengan nilai yang diambil dari konstanta LINELOCATIONOPTION_.

dwCancelCallWaitingSize

Ukuran, dalam byte, dari string cancel-call-waiting.

dwCancelCallWaitingOffset

Ukuran offset, ditentukan dalam dwCancelCallWaitingSize, dari awal struktur LINETRANSLATECAPS ke string null-terminated yang berisi digit dial dan karakter pengubah yang harus diawali ke string dialable (setelah karakter pulsa/nada) ketika aplikasi menetapkan LINETRANSLATEOPTION_CANCELCALLWAITING bit dalam parameter dwTranslateOptionsdari lineTranslateAddress. Jika tidak ada awalan yang ditentukan, dwCancelCallWaitingSize dapat diatur ke nol, atau 1, dan dwCancelCallWaitingOffset dapat menunjuk ke string kosong (byte NULL tunggal).

Keterangan

Struktur ini tidak dapat diperpanjang.

Aplikasi lama dikompilasi tanpa pengetahuan tentang bidang baru ini, dan menggunakan SIZEOF LINELOCATIONENTRY yang lebih kecil dari ukuran baru. Karena ini adalah array dalam bagian variabel dari struktur LINETRANSLATECAPS , sangat penting bahwa aplikasi yang lebih lama menerima struktur LINELOCATIONENTRY dalam format yang diharapkan sebelumnya, atau tidak dapat mengindeks melalui array dengan benar. Aplikasi lolos dalam parameter dwAPIVersion dengan fungsi lineGetTranslateCaps , yang dapat digunakan untuk panduan oleh TAPI dalam menangani situasi ini. Fungsi lineGetTranslateCaps harus menggunakan anggota dan ukuran LINELOCATIONENTRY yang cocok dengan versi API yang ditunjukkan, saat membangun struktur LINETRANSLATECAPS untuk dikembalikan ke aplikasi.

Persyaratan

Persyaratan	Nilai
Header	tapi.h

Lihat juga