fungsi phoneNegotiateExtVersion (tapi.h)

Artikel
03/02/2024

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

Sintaks

LONG phoneNegotiateExtVersion(
  HPHONEAPP hPhoneApp,
  DWORD     dwDeviceID,
  DWORD     dwAPIVersion,
  DWORD     dwExtLowVersion,
  DWORD     dwExtHighVersion,
  LPDWORD   lpdwExtVersion
);

Parameter

hPhoneApp

Tangani pendaftaran aplikasi dengan TAPI.

dwDeviceID

Pengidentifikasi perangkat telepon yang akan dikueri.

dwAPIVersion

Nomor versi API yang dinegosiasikan untuk perangkat telepon yang ditentukan menggunakan phoneNegotiateAPIVersion.

dwExtLowVersion

Versi ekstensi terbaru dari pengidentifikasi ekstensi yang dikembalikan oleh phoneNegotiateAPIVersion 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 phoneNegotiateAPIVersion yang mematuhi aplikasi. Kata urutan tinggi adalah nomor versi utama; kata berurutan rendah adalah nomor versi minor.

lpdwExtVersion

Arahkan ke DWORD tempat nomor versi ekstensi yang dinegosiasikan dikembalikan. Jika negosiasi berhasil, angka ini berada dalam rentang dwExtLowVersion ke dwExtHighVersion.

Mengembalikan nilai

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

PHONEERR_INVALAPPHANDLE, PHONEERR_OPERATIONFAILED, PHONEERR_BADDEVICEID, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NODRIVER, PHONEERR_NOMEM, PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INCOMPATIBLEEXTVERSION, PHONEERR_UNINITIALIZED, PHONEERR_INVALPOINTER, PHONEERR_NODEVICE.

Keterangan

Fungsi phoneNegotiateExtVersion digunakan untuk menegosiasikan nomor versi API untuk digunakan. Ini mengembalikan pengidentifikasi ekstensi yang didukung oleh perangkat telepon, atau nol jika tidak ada ekstensi yang disediakan.

Agar aplikasi dapat menggunakan ekstensi yang ditentukan oleh pengidentifikasi ekstensi yang dikembalikan, aplikasi harus memanggil phoneNegotiateExtVersion untuk menegosiasikan versi ekstensi yang akan digunakan.

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

Nomor versi ekstensi yang dinegosiasikan adalah bahwa di mana aplikasi dan penyedia layanan harus beroperasi. Jika rentang versi tidak tumpang tindih, versi aplikasi dan penyedia layanan tidak kompatibel dan kesalahan dikembalikan.