fungsi lineGetCountry (tapi.h)

  • Artikel

Fungsi lineGetCountry mengambil aturan panggilan tersimpan dan informasi lain yang terkait dengan negara/wilayah tertentu, negara/wilayah pertama dalam daftar negara/wilayah, atau semua negara/wilayah.

Sintaks

LONG lineGetCountry(
  DWORD             dwCountryID,
  DWORD             dwAPIVersion,
  LPLINECOUNTRYLIST lpLineCountryList
);

Parameter

dwCountryID

Pengidentifikasi negara/wilayah (bukan kode negara) negara/wilayah tempat informasi akan diperoleh. Jika nilai 1 ditentukan, informasi tentang negara/wilayah pertama di daftar negara/wilayah diperoleh. Jika nilai 0 ditentukan, informasi tentang semua negara/wilayah diperoleh (yang dapat membutuhkan banyak memori — 20 KB atau lebih).

dwAPIVersion

Versi TERTINGGI TAPI yang didukung oleh aplikasi (belum tentu nilai yang dinegosiasikan oleh lineNegotiateAPIVersion pada beberapa perangkat baris tertentu).

lpLineCountryList

Penunjuk ke lokasi tempat struktur LINECOUNTRYLIST dimuat. Sebelum memanggil lineGetCountry, aplikasi harus mengatur anggota dwTotalSize dari struktur ini untuk menunjukkan jumlah memori yang tersedia untuk TAPI untuk mengembalikan informasi.

Catatan Jika parameter ukuran dalam struktur tidak benar, ada kemungkinan data bisa ditimpa. Untuk informasi selengkapnya tentang pengaturan ukuran struktur, lihat topik alokasi memori .
 

Mengembalikan nilai

Mengembalikan nol jika permintaan berhasil atau angka kesalahan negatif jika terjadi kesalahan. Nilai yang mungkin dikembalikan adalah:

LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_NOMEM, LINEERR_INIFILECORRUPT, LINEERR_OPERATIONFAILED, LINEERR_INVALCOUNTRYCODE, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALPOINTER.

Persyaratan

Persyaratan Nilai
Target Platform Windows
Header tapi.h
Pustaka Tapi32.lib
DLL Tapi32.dll

Lihat juga

Referensi Layanan Telepon Dasar

LINECOUNTRYLIST

Gambaran Umum Referensi TAPI 2.2

lineNegotiateAPIVersion