fungsi lineNegotiateAPIVersion (tapi.h)

Artikel
03/04/2024

Fungsi lineNegotiateAPIVersion memungkinkan aplikasi untuk menegosiasikan versi API untuk digunakan.

Sintaks

LONG lineNegotiateAPIVersion(
  HLINEAPP          hLineApp,
  DWORD             dwDeviceID,
  DWORD             dwAPILowVersion,
  DWORD             dwAPIHighVersion,
  LPDWORD           lpdwAPIVersion,
  LPLINEEXTENSIONID lpExtensionID
);

Parameter

hLineApp

Tangani pendaftaran aplikasi dengan TAPI.

dwDeviceID

Pengidentifikasi perangkat baris yang akan dikueri.

dwAPILowVersion

Versi TAPI paling awal yang sesuai dengan aplikasi. Kata urutan tinggi adalah nomor versi utama; kata berurutan rendah adalah nomor versi minor.

dwAPIHighVersion

Versi TAPI terbaru yang sesuai dengan aplikasi. Kata urutan tinggi adalah nomor versi utama; kata berurutan rendah adalah nomor versi minor.

lpdwAPIVersion

Pointer ke variabel yang berisi nomor versi TAPI yang dinegosiasikan. Jika negosiasi berhasil, jumlah ini berada dalam rentang antara dwAPILowVersion dan dwAPIHighVersion.

lpExtensionID

Pointer ke struktur jenis LINEEXTENSIONID. Jika penyedia layanan untuk dwDeviceID yang ditentukan mendukung ekstensi khusus penyedia, maka, setelah negosiasi berhasil, struktur ini diisi dengan pengidentifikasi ekstensi ekstensi ini. Struktur ini berisi semua nol jika baris tidak menyediakan ekstensi. Aplikasi dapat mengabaikan parameter yang dikembalikan jika tidak menggunakan ekstensi.

Mengembalikan nilai

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

LINEERR_BADDEVICEID, LINEERR_NODRIVER, LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_OPERATIONFAILED, LINEERR_INVALAPPHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM, LINEERR_OPERATIONUNAVAIL, LINEERR_NODEVICE.

Keterangan

Gunakan lineInitializeEx untuk menentukan jumlah perangkat baris yang ada dalam sistem. Pengidentifikasi perangkat yang ditentukan oleh dwDeviceID bervariasi dari nol hingga satu kurang dari jumlah perangkat baris yang ada.

Fungsi lineNegotiateAPIVersion digunakan untuk menegosiasikan nomor versi API untuk digunakan. Ini juga mengambil pengidentifikasi ekstensi yang didukung oleh perangkat baris, dan mengembalikan nol jika tidak ada ekstensi yang didukung. Jika aplikasi ingin menggunakan ekstensi yang ditentukan oleh pengidentifikasi ekstensi yang dikembalikan, aplikasi harus memanggil lineNegotiateExtVersion untuk menegosiasikan versi ekstensi yang akan digunakan.

Nomor versi API yang dinegosiasikan adalah bahwa DI MANA TAPI dapat beroperasi. Jika rentang versi tidak tumpang tindih, versi aplikasi dan API atau penyedia layanan tidak kompatibel dan kesalahan dikembalikan.