TSPI_lineNegotiateExtVersion (tspi.h)

  • Artikel

Fungsi TSPI_lineNegotiateExtVersion mengembalikan nomor versi ekstensi tertinggi yang dapat dioperasikan penyedia layanan untuk perangkat ini, mengingat rentang kemungkinan versi ekstensi.

Sintaks

LONG TSPIAPI TSPI_lineNegotiateExtVersion(
  DWORD   dwDeviceID,
  DWORD   dwTSPIVersion,
  DWORD   dwLowVersion,
  DWORD   dwHighVersion,
  LPDWORD lpdwExtVersion
);

Parameter

dwDeviceID

Mengidentifikasi perangkat baris tempat negosiasi versi antarmuka akan dilakukan. Nilai INITIALIZE_NEGOTIATION mungkin tidak digunakan untuk fungsi ini.

dwTSPIVersion

Nomor versi antarmuka yang telah dinegosiasikan untuk perangkat ini menggunakan TSPI_lineNegotiateTSPIVersion. Fungsi ini beroperasi sesuai dengan spesifikasi antarmuka pada tingkat versi ini.

dwLowVersion

Nomor versi ekstensi terendah di mana TAPI atau aplikasi kliennya dapat beroperasi. WORD yang paling signifikan adalah nomor versi utama dan WORD yang paling tidak signifikan adalah nomor versi minor. TAPI tidak memvalidasi parameter ini ketika fungsi ini dipanggil.

dwHighVersion

Nomor versi ekstensi tertinggi di mana TAPI atau aplikasi kliennya dapat beroperasi. WORD yang paling signifikan adalah nomor versi utama dan WORD yang paling tidak signifikan adalah nomor versi minor. TAPI tidak memvalidasi parameter ini ketika fungsi ini dipanggil.

lpdwExtVersion

Penunjuk ke DWORD. Setelah berhasil kembali dari fungsi ini, penyedia layanan mengisi lokasi ini dengan nomor versi ekstensi tertinggi, dalam rentang yang diminta oleh pemanggil, di mana penyedia layanan dapat beroperasi. WORD yang paling signifikan adalah nomor versi utama dan WORD yang paling tidak signifikan adalah nomor versi minor. Jika rentang yang diminta tidak tumpang tindih dengan rentang yang didukung oleh penyedia layanan, fungsi mengembalikan LINEERR_INCOMPATIBLEEXTVERSION.

Nilai kembali

Mengembalikan nol jika fungsi berhasil, atau angka kesalahan jika terjadi kesalahan. Kemungkinan nilai yang dikembalikan adalah sebagai berikut:

LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_OPERATIONUNAVAIL, LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_OPERATIONFAILED, LINEERR_NODRIVER, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM.

Keterangan

Fungsi ini dapat dipanggil sebelum atau sesudah perangkat dibuka oleh TAPI. Jika perangkat saat ini terbuka dan memiliki versi ekstensi yang dipilih, fungsi memberikan nomor versi tersebut jika berada dalam rentang yang diminta. Jika nomor versi yang dipilih berada di luar rentang yang diminta, fungsi akan mengembalikan LINEERR_INCOMPATIBLEEXTVERSION.

Persyaratan

   
Target Platform Windows
Header tspi.h

Lihat juga

INITIALIZE_NEGOTIATION

TSPI_lineNegotiateTSPIVersion