Struktur LINECARDENTRY (tapi.h)

Struktur LINECARDENTRY menjelaskan kartu panggilan. Struktur LINETRANSLATECAPS dapat berisi array struktur LINECARDENTRY .

Sintaks

typedef struct linecardentry_tag {
  DWORD dwPermanentCardID;
  DWORD dwCardNameSize;
  DWORD dwCardNameOffset;
  DWORD dwCardNumberDigits;
  DWORD dwSameAreaRuleSize;
  DWORD dwSameAreaRuleOffset;
  DWORD dwLongDistanceRuleSize;
  DWORD dwLongDistanceRuleOffset;
  DWORD dwInternationalRuleSize;
  DWORD dwInternationalRuleOffset;
  DWORD dwOptions;
} LINECARDENTRY, *LPLINECARDENTRY;

Anggota

dwPermanentCardID

Pengidentifikasi permanen yang mengidentifikasi kartu.

dwCardNameSize

Ukuran string nama kartu termasuk terminator null , dalam byte.

dwCardNameOffset

Offset dari awal struktur ke string yang dihentikan null yang menjelaskan kartu dengan cara yang mudah digunakan. Ukuran bidang ditentukan oleh dwCardNameSize.

dwCardNumberDigits

Jumlah digit dalam nomor kartu yang ada. Nomor kartu itu sendiri tidak dikembalikan karena alasan keamanan (disimpan dalam bentuk orak-arik oleh TAPI). Aplikasi dapat menggunakan ini untuk menyisipkan byte pengisi ke dalam kontrol teks dalam mode "kata sandi" untuk menunjukkan bahwa ada angka.

dwSameAreaRuleSize

Ukuran aturan putar-nomor area yang sama termasuk terminator null , dalam byte.

dwSameAreaRuleOffset

Offset dari awal struktur LINETRANSLATECAPS ke aturan panggilan yang ditentukan untuk panggilan ke nomor dalam kode area yang sama. Aturan adalah string yang dihentikan null. Ukuran bidang ditentukan oleh dwSameAreaRuleSize.

dwLongDistanceRuleSize

Ukuran aturan putar nomor jarak jauh termasuk terminator null , dalam byte.

dwLongDistanceRuleOffset

Offset dari awal struktur ke aturan panggilan yang ditentukan untuk panggilan ke nomor di area lain di negara/wilayah yang sama. Aturan adalah string yang dihentikan null. Ukuran bidang ditentukan oleh dwLongDistanceRuleSize.

dwInternationalRuleSize

Ukuran aturan panggilan internasional termasuk terminator null , dalam byte.

dwInternationalRuleOffset

Offset dari awal struktur ke aturan panggilan yang ditentukan untuk panggilan ke nomor di negara/wilayah lain. Aturan adalah string yang dihentikan null. Ukuran bidang ditentukan oleh dwInternationalRuleSize.

dwOptions

Menunjukkan pengaturan lain yang terkait dengan kartu panggilan ini, menggunakan konstanta LINECARDOPTION_.

Keterangan

Aplikasi lama dikompilasi tanpa pengetahuan tentang bidang baru ini, dan menggunakan SIZEOF(LINECARDENTRY) 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 LINECARDENTRY dalam format yang diharapkan sebelumnya, atau mereka tidak dapat mengindeks dengan benar melalui array. Aplikasi lolos dalam parameter dwAPIVersion dengan fungsi lineGetTranslateCaps , yang dapat digunakan untuk panduan oleh TAPI dalam menangani situasi ini. Fungsi lineGetTranslateCaps harus menggunakan bidang dan ukuran LINECARDENTRY yang cocok dengan versi API yang ditunjukkan, saat membangun struktur LINETRANSLATECAPS untuk dikembalikan ke aplikasi.

Struktur ini mungkin tidak diperpanjang.

Persyaratan

Persyaratan	Nilai
Header	tapi.h

Lihat juga

LINETRANSLATECAPS

lineGetTranslateCaps