fungsi lineGetTranslateCaps (tapi.h)

Artikel
03/08/2023

Fungsi lineGetTranslateCaps mengembalikan kemampuan terjemahan alamat.

Sintaks

LONG lineGetTranslateCaps(
  HLINEAPP            hLineApp,
  DWORD               dwAPIVersion,
  LPLINETRANSLATECAPS lpTranslateCaps
);

Parameter

hLineApp

Menangani yang dikembalikan oleh fungsi lineInitializeEx . Jika aplikasi belum memanggil fungsi lineInitializeEx , parameter ini bisa nol.

Catatan Aplikasi TAPI 1.4 harus mengatur parameter ini ke handel hLineApp yang valid, seperti yang dikembalikan oleh fungsi lineInitialize .

dwAPIVersion

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

lpTranslateCaps

Pointer ke lokasi tempat struktur LINETRANSLATECAPS dimuat. Sebelum memanggil lineGetTranslateCaps, 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 .

Menampilkan 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_INVALAPPHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NODRIVER.