fungsi phoneNegotiateExtVersion (tapi.h)
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.
Persyaratan
| Target Platform | Windows |
| Header | tapi.h |
| Pustaka | Tapi32.lib |
| DLL | Tapi32.dll |
Lihat juga
Referensi Layanan Telepon yang Diperluas