fungsi lineNegotiateExtVersion (tapi.h)

Artikel
03/08/2023

Fungsi lineNegotiateExtVersion memungkinkan aplikasi untuk menegosiasikan versi ekstensi untuk digunakan dengan perangkat baris yang ditentukan. Operasi ini tidak perlu dipanggil jika aplikasi tidak mendukung ekstensi.

Sintaks

LONG lineNegotiateExtVersion(
  HLINEAPP hLineApp,
  DWORD    dwDeviceID,
  DWORD    dwAPIVersion,
  DWORD    dwExtLowVersion,
  DWORD    dwExtHighVersion,
  LPDWORD  lpdwExtVersion
);

Parameter

hLineApp

Tangani pendaftaran aplikasi dengan TAPI.

dwDeviceID

Pengidentifikasi perangkat baris yang akan dikueri.

dwAPIVersion

Nomor versi TAPI yang dinegosiasikan untuk perangkat baris yang ditentukan menggunakan lineNegotiateAPIVersion.

dwExtLowVersion

Versi ekstensi paling awal dari pengidentifikasi ekstensi yang dikembalikan oleh lineNegotiateAPIVersion yang sesuai dengan aplikasi. Kata urutan tinggi adalah nomor versi utama; kata berurutan rendah adalah nomor versi minor.

dwExtHighVersion

Versi ekstensi terbaru dari pengidentifikasi ekstensi yang dikembalikan oleh lineNegotiateAPIVersion yang sesuai dengan aplikasi. Kata urutan tinggi adalah nomor versi utama; kata berurutan rendah adalah nomor versi minor.

lpdwExtVersion

Penunjuk ke variabel yang berisi nomor versi ekstensi yang dinegosiasikan. Jika negosiasi berhasil, angka ini berada dalam rentang antara dwExtLowVersion dan dwExtHighVersion.

Mengembalikan nilai

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

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

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 menegosiasikan nomor versi API untuk digunakan. Ini juga mengambil pengidentifikasi ekstensi yang didukung oleh perangkat baris, yang merupakan nol jika tidak ada ekstensi yang disediakan. Nomor versi harus bertambah satu per satu untuk setiap rilis. Meninggalkan celah dalam penomoran versi rilis dapat menyebabkan hasil yang tidak terduga.

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 ekstensi yang dinegosiasikan adalah bahwa di mana aplikasi dan penyedia layanan harus beroperasi. Jika rentang versi tidak tumpang tindih, versi penyedia aplikasi dan layanan tidak kompatibel dan kesalahan dikembalikan.