fungsi phoneNegotiateAPIVersion (tapi.h)

Artikel
03/13/2024

PhoneNegotiateAPIVersion memungkinkan aplikasi untuk menegosiasikan versi API untuk digunakan untuk perangkat telepon yang ditentukan.

Sintaks

LONG phoneNegotiateAPIVersion(
  HPHONEAPP          hPhoneApp,
  DWORD              dwDeviceID,
  DWORD              dwAPILowVersion,
  DWORD              dwAPIHighVersion,
  LPDWORD            lpdwAPIVersion,
  LPPHONEEXTENSIONID lpExtensionID
);

Parameter

hPhoneApp

Tangani pendaftaran aplikasi dengan TAPI.

dwDeviceID

Pengidentifikasi perangkat telepon yang akan dikueri.

dwAPILowVersion

Versi API terbaru yang mematuhi aplikasi. Kata urutan tinggi adalah nomor versi utama, kata urutan rendah adalah nomor versi minor.

dwAPIHighVersion

Versi API terbaru yang mematuhi aplikasi. Kata urutan tinggi adalah nomor versi utama, kata urutan rendah adalah nomor versi minor.

lpdwAPIVersion

Penunjuk ke DWORD tempat nomor versi API yang dinegosiasikan akan dikembalikan. Jika negosiasi berhasil, jumlah ini berada dalam rentang dwAPILowVersion ke dwAPIHighVersion.

lpExtensionID

Penunjuk ke struktur jenis PHONEEXTENSIONID. Jika penyedia layanan untuk parameter dwDeviceID yang ditentukan mendukung ekstensi khusus penyedia, struktur ini diisi dengan pengidentifikasi ekstensi ekstensi ini saat negosiasi berhasil. 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 nomor kesalahan negatif jika terjadi kesalahan. Nilai yang mungkin dikembalikan adalah:

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

Keterangan

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

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