Bagikan melalui


Konstanta LINEERR_

Berikut ini adalah daftar kode kesalahan yang dapat dikembalikan TAPI saat memanggil operasi pada baris, alamat, atau panggilan. Untuk informasi selengkapnya tentang cara menentukan kode kesalahan mana yang dapat dikembalikan oleh fungsi tertentu, lihat deskripsi fungsi individual.

LINEERR_ADDRESSBLOCKED

Alamat yang ditentukan diblokir agar tidak dihubungi pada panggilan yang ditentukan.

LINEERR_ADDRESSBLOCKED

Alamat panggilan target mengaktifkan pemblokiran panggilan.

LINEERR_ALLOCATED

Baris tidak dapat dibuka karena kondisi persisten, seperti port seri yang dibuka secara eksklusif oleh proses lain.

LINEERR_BADDEVICEID

Pengidentifikasi perangkat atau pengidentifikasi perangkat baris yang ditentukan, seperti dalam parameter dwDeviceID , tidak valid atau di luar rentang.

LINEERR_BEARERMODEUNAVAIL

Anggota mode pembawa di LINECALLPARAMS tidak valid, mode pembawa yang ditentukan dalam LINECALLPARAMS tidak tersedia, atau mode pembawa panggilan tidak dapat diubah ke mode pembawa yang ditentukan.

LINEERR_BILLINGREJECTED

Mode penagihan panggilan ditolak.

LINEERR_CALLUNAVAIL

Semua tampilan panggilan pada alamat yang ditentukan saat ini sedang digunakan.

LINEERR_COMPLETIONOVERRUN

Jumlah maksimum penyelesaian panggilan yang terutang telah terlampaui.

LINEERR_CONFERENCEFULL

Jumlah maksimum pihak untuk konferensi telah tercapai, atau jumlah pihak yang diminta tidak dapat dipenuhi.

LINEERR_DIALBILLING

Parameter alamat bisa-putar memuat karakter kontrol putar nomor yang tidak diproses oleh penyedia layanan.

LINEERR_DIALDIALTONE

Parameter alamat bisa-putar memuat karakter kontrol putar nomor yang tidak diproses oleh penyedia layanan.

LINEERR_DIALPROMPT

Parameter alamat bisa-putar memuat karakter kontrol putar nomor yang tidak diproses oleh penyedia layanan.

LINEERR_DIALQUIET

Parameter alamat bisa-putar memuat karakter kontrol putar nomor yang tidak diproses oleh penyedia layanan.

LINEERR_DIALVOICEDETECT

Penggunaan pengubah putar-putar (:) tidak didukung. Nilai ini hanya diekspos ke aplikasi yang menegosiasikan VERSI TAPI 2.0 atau yang lebih baru.

LINEERR_DISCONNECTED

Panggilan telah terputus. Nilai ini hanya diekspos ke aplikasi yang menegosiasikan versi TAPI 2.2 atau yang lebih baru.

LINEERR_INCOMPATIBLEAPIVERSION

Aplikasi meminta versi TAPI atau rentang versi yang tidak kompatibel dengan, atau tidak dapat didukung oleh, implementasi API Telepon dan penyedia layanan yang sesuai.

LINEERR_INCOMPATIBLEEXTVERSION

Aplikasi meminta rentang versi ekstensi yang tidak valid atau tidak dapat didukung oleh penyedia layanan yang sesuai.

LINEERR_INIFILECORRUPT

File Telephon.ini tidak dapat dibaca atau dipahami dengan benar oleh TAPI karena inkonsistensi internal atau masalah pemformatan. Misalnya, bagian [Lokasi], [Kartu], atau [Negara] dari file Telephon.ini mungkin rusak atau tidak konsisten.

LINEERR_INUSE

Perangkat baris sedang digunakan dan saat ini tidak dapat dikonfigurasi, memungkinkan pihak ditambahkan, mengizinkan panggilan untuk dijawab, mengizinkan panggilan dilakukan, atau mengizinkan panggilan ditransfer.

LINEERR_INVALADDRESS

Alamat yang ditentukan tidak valid atau tidak diperbolehkan. Jika tidak valid, alamat berisi karakter atau digit yang tidak valid, atau alamat tujuan berisi karakter kontrol putar nomor (W, @, $, atau ?) yang tidak didukung oleh penyedia layanan. Jika tidak diizinkan, alamat yang ditentukan tidak ditetapkan ke baris yang ditentukan atau tidak valid untuk pengalihan alamat.

LINEERR_INVALADDRESSID

Pengidentifikasi alamat yang ditentukan tidak valid atau di luar rentang.

LINEERR_INVALADDRESSMODE

Mode alamat yang ditentukan tidak valid.

LINEERR_INVALADDRESSSTATE

Status alamat yang ditentukan berisi satu atau beberapa bit yang tidak LINEADDRESSSTATE_ konstanta.

LINEERR_INVALADDRESSTYPE

Aplikasi mereferensikan tipe alamat yang tidak valid. Nilai ini hanya diekspos ke aplikasi yang menegosiasikan VERSI TAPI 3.0 atau yang lebih baru.

LINEERR_INVALAGENTACTIVITY

Aktivitas agen yang ditentukan tidak valid.

LINEERR_INVALAGENTACTIVITY

Aplikasi yang memanggil operasi ini adalah target handoff tidak langsung. Artinya, TAPI telah menentukan bahwa aplikasi panggilan juga merupakan aplikasi prioritas tertinggi untuk jenis media tertentu. Nilai ini hanya diekspos ke aplikasi yang menegosiasikan VERSI TAPI 2.0 atau yang lebih baru.

LINEERR_INVALAGENTGROUP

Informasi grup agen yang ditentukan tidak valid atau berisi kesalahan. Tindakan yang diminta belum dilakukan.

LINEERR_INVALAGENTGROUP

Aplikasi mereferensikan grup agen yang tidak valid. Nilai ini hanya diekspos ke aplikasi yang menegosiasikan VERSI TAPI 2.0 atau yang lebih baru.

LINEERR_INVALAGENTID

Pengidentifikasi agen yang ditentukan tidak valid.

LINEERR_INVALAGENTID

Pengidentifikasi agen yang tidak valid digunakan. Nilai ini hanya diekspos ke aplikasi yang menegosiasikan VERSI TAPI 2.0 atau yang lebih baru.

LINEERR_INVALAGENTSESSIONSTATE

Status sesi agen tidak valid. Nilai ini hanya diekspos ke aplikasi yang menegosiasikan versi TAPI 2.2 atau yang lebih baru.

LINEERR_INVALAGENTSTATE

Status agen yang ditentukan tidak valid atau berisi kesalahan. Tidak ada perubahan yang dilakukan pada status agen dari alamat yang ditentukan.

LINEERR_INVALAGENTSTATE

Aplikasi mereferensikan status agen yang tidak valid. Nilai ini hanya diekspos ke aplikasi yang menegosiasikan VERSI TAPI 2.0 atau yang lebih baru.

LINEERR_INVALAPPHANDLE

Handel aplikasi (seperti yang ditentukan oleh parameter hLineApp ) atau handel pendaftaran aplikasi tidak valid.

LINEERR_INVALAPPNAME

Nama aplikasi yang ditentukan tidak valid. Jika nama aplikasi ditentukan oleh aplikasi, diasumsikan bahwa string tidak berisi karakter yang tidak dapat ditampilkan, dan tidak dihentikan.

LINEERR_INVALBEARERMODE

Mode pembawa yang ditentukan tidak valid.

LINEERR_INVALCALLCOMPLMODE

Penyelesaian yang ditentukan tidak valid.

LINEERR_INVALCALLHANDLE

Handel panggilan yang ditentukan tidak valid. Misalnya, handel bukan NULL tetapi bukan milik baris yang diberikan. Dalam beberapa kasus, handel perangkat panggilan yang ditentukan tidak valid.

LINEERR_INVALCALLPARAMS

Parameter panggilan yang ditentukan tidak valid.

LINEERR_INVALCALLPRIVILEGE

Parameter hak istimewa panggilan yang ditentukan tidak valid.

LINEERR_INVALCALLSELECT

Parameter pilih yang ditentukan tidak valid.

LINEERR_INVALCALLSTATE

Status panggilan saat ini tidak dalam status valid untuk operasi yang diminta.

LINEERR_INVALCALLSTATELIST

Daftar status panggilan yang ditentukan tidak valid.

LINEERR_INVALCARD

Pengidentifikasi kartu permanen yang ditentukan dalam dwCard tidak dapat ditemukan di entri apa pun di bagian [Kartu] di registri.

LINEERR_INVALCOMPLETIONID

Pengidentifikasi penyelesaian tidak valid.

LINEERR_INVALCONFCALLHANDLE

Handel panggilan yang ditentukan untuk panggilan konferensi tidak valid atau bukan handel untuk panggilan konferensi.

LINEERR_INVALCONSULTCALLHANDLE

Handel panggilan konsultasi yang ditentukan tidak valid.

LINEERR_INVALCOUNTRYCODE

Kode negara atau wilayah yang ditentukan tidak valid.

LINEERR_INVALDEVICECLASS

Perangkat baris tidak memiliki perangkat terkait untuk kelas perangkat tertentu, atau baris yang ditentukan tidak mendukung kelas perangkat yang ditunjukkan.

LINEERR_INVALDEVICEHANDLE

Handel perangkat baris tidak valid.

LINEERR_INVALDIALPARAMS

Parameter pemutaran tidak valid.

LINEERR_INVALDIGITLIST

Daftar digit yang ditentukan tidak valid.

LINEERR_INVALDIGITMODE

Mode digit yang ditentukan tidak valid.

LINEERR_INVALDIGITS

Digit penghentian yang ditentukan tidak valid.

LINEERR_INVALEXTVERSION

Nomor versi ekstensi penyedia layanan tidak valid.

LINEERR_INVALFEATURE

Parameter dwFeature tidak valid.

LINEERR_INVALFEATURE

Aplikasi memanggil fitur yang tidak tersedia pada baris ini.

LINEERR_INVALGROUPID

Pengidentifikasi grup yang ditentukan tidak valid.

LINEERR_INVALLINEHANDLE

Panggilan, perangkat, perangkat baris, atau handel baris yang ditentukan tidak valid.

LINEERR_INVALLINESTATE

Konfigurasi perangkat mungkin tidak diubah dalam status baris saat ini. Baris mungkin digunakan oleh aplikasi lain atau parameter dwLineStates berisi satu atau beberapa bit yang tidak LINEDEVSTATE_ konstanta. Nilai LINEERR_INVALLINESTATE juga dapat menunjukkan bahwa perangkat terputus atau tidak aktif. Status ini ditunjukkan dengan mengatur bit yang sesuai dengan nilai LINEDEVSTATUSFLAGS_CONNECTED dan LINEDEVSTATUSFLAGS_INSERVICE ke 0 di anggota dwDevStatusFlags dari struktur LINEDEVSTATUS yang dikembalikan oleh fungsi lineGetLineDevStatus .

LINEERR_INVALLOCATION

Pengidentifikasi lokasi permanen yang ditentukan dalam dwLocation tidak dapat ditemukan di entri apa pun di bagian [Lokasi] di registri.

LINEERR_INVALMEDIALIST

Daftar media yang ditentukan tidak valid.

LINEERR_INVALMEDIAMODE

Daftar tipe media (mode) yang akan dipantau berisi informasi yang tidak valid, parameter tipe media yang ditentukan tidak valid, atau penyedia layanan tidak mendukung tipe media yang ditentukan. Jenis media yang didukung pada baris tercantum dalam anggota dwMediaModes dalam struktur LINEDEVCAPS .

LINEERR_INVALMESSAGEID

Angka yang diberikan dalam dwMessageID berada di luar rentang yang ditentukan oleh anggota dwNumCompletionMessages dalam struktur LINEADDRESSCAPS .

LINEERR_INVALPARAM

Parameter atau struktur yang dituju parameter berisi informasi yang tidak valid, kode negara atau wilayah tidak valid, handel jendela tidak valid, atau parameter daftar terusan yang ditentukan berisi informasi yang tidak valid.

LINEERR_INVALPARKID

Pengidentifikasi taman tidak valid.

LINEERR_INVALPARKMODE

Mode taman yang ditentukan tidak valid.

LINEERR_INVALPASSWORD

Kata sandi yang ditentukan tidak benar dan tindakan yang diminta belum dilakukan.

LINEERR_INVALPASSWORD

Aplikasi menggunakan kata sandi yang tidak valid. Nilai ini hanya diekspos ke aplikasi yang menegosiasikan VERSI TAPI 2.0 atau yang lebih baru.

LINEERR_INVALPOINTER

Satu atau beberapa parameter pointer yang ditentukan (seperti lpCallList, lpdwAPIVersion, lpExtensionID, lpdwExtVersion, lphIcon, lpLineDevCaps, dan lpToneList) tidak valid, atau pointer yang diperlukan ke parameter output adalah NULL.

LINEERR_INVALPRIVSELECT

Bendera yang tidak valid atau kombinasi bendera diatur untuk parameter dwPrivileges .

LINEERR_INVALRATE

Laju yang ditentukan tidak valid.

LINEERR_INVALREQUESTMODE

Indikator LINEREQUESTMODE tidak valid.

LINEERR_INVALTERMINALID

Pengidentifikasi terminal yang ditentukan tidak valid.

LINEERR_INVALTERMINALMODE

Parameter mode terminal yang ditentukan tidak valid.

LINEERR_INVALTIMEOUT

Batas waktu tidak didukung atau nilai berada di luar rentang valid yang ditentukan dalam LINEDEVCAPS.

LINEERR_INVALTONE

Nada kustom yang ditentukan tidak mewakili nada yang valid atau terdiri dari terlalu banyak frekuensi atau struktur nada yang ditentukan tidak menjelaskan nada yang valid.

LINEERR_INVALTONELIST

Daftar nada yang ditentukan tidak valid.

LINEERR_INVALTONEMODE

Parameter mode nada yang ditentukan tidak valid.

LINEERR_INVALTRANSFERMODE

Parameter mode transfer yang ditentukan tidak valid.

LINEERR_LINEMAPPERFAILED

LINEMAPPER adalah nilai yang diteruskan dalam parameter dwDeviceID , tetapi tidak ada baris yang ditemukan yang cocok dengan persyaratan yang ditentukan dalam parameter lpCallParams .

LINEERR_NOCONFERENCE

Panggilan yang ditentukan bukan handel panggilan konferensi atau panggilan peserta.

LINEERR_NODEVICE

Pengidentifikasi perangkat yang ditentukan, yang sebelumnya valid, tidak lagi diterima karena perangkat terkait telah dihapus dari sistem sejak TAPI terakhir diinisialisasi. Secara bergantian, perangkat baris tidak memiliki perangkat terkait untuk kelas perangkat yang diberikan.

LINEERR_NODRIVER

Baik Tapiaddr.dll tidak dapat ditemukan atau penyedia layanan telepon untuk perangkat yang ditentukan menemukan bahwa salah satu komponennya hilang atau rusak dengan cara yang tidak terdeteksi pada waktu inisialisasi. Pengguna harus disarankan untuk menggunakan Panel Kontrol Telepon untuk memperbaiki masalah.

LINEERR_NOMEM

Memori tidak cukup untuk melakukan operasi, atau tidak dapat mengunci memori.

LINEERR_NOMULTIPLEINSTANCE

Penyedia layanan telepon yang tidak mendukung beberapa instans tercantum lebih dari sekali di bagian [Penyedia] di registri. Aplikasi harus menyarankan pengguna untuk menggunakan telefoni Panel Kontrol untuk menghapus driver duplikat.

LINEERR_NOMULTIPLEINSTANCE

Beberapa instans penyedia layanan ini tidak diizinkan.

LINEERR_NOREQUEST

Saat ini tidak ada permintaan yang tertunda dari mode yang ditunjukkan, atau aplikasi tidak lagi menjadi aplikasi berprioritas tertinggi untuk mode permintaan yang ditentukan.

LINEERR_NOTOWNER

Aplikasi tidak memiliki hak istimewa pemilik untuk panggilan yang ditentukan.

LINEERR_NOTREGISTERED

Aplikasi tidak terdaftar sebagai penerima permintaan untuk mode permintaan yang ditunjukkan.

LINEERR_OPERATIONFAILED

Operasi gagal karena alasan yang tidak ditentukan atau tidak diketahui.

LINEERR_OPERATIONUNAVAIL

Operasi tidak tersedia, seperti untuk perangkat tertentu atau baris yang ditentukan.

LINEERR_RATEUNAVAIL

Penyedia layanan saat ini tidak memiliki cukup bandwidth yang tersedia untuk tarif yang ditentukan.

LINEERR_REINIT

Jika reinisialisasi TAPI telah diminta, misalnya sebagai akibat dari menambahkan atau menghapus penyedia layanan telepon, maka lineInitialize, lineInitializeEx, atau lineOpen permintaan ditolak dengan kesalahan ini sampai aplikasi terakhir mematikan penggunaan API (menggunakan lineShutdown), pada saat itu konfigurasi baru menjadi efektif dan aplikasi sekali lagi diizinkan untuk memanggil lineInitialize atau lineInitializeEx.

LINEERR_REINIT

Aplikasi mencoba menginisialisasi TAPI dua kali.

LINEERR_REQUESTOVERRUN

Lebih banyak permintaan tertunda daripada yang dapat ditangani perangkat.

LINEERR_RESOURCEUNAVAIL

Sumber daya tidak cukup untuk menyelesaikan operasi. Misalnya, baris tidak dapat dibuka karena overcommitment sumber daya dinamis.

LINEERR_STRUCTURETOOSMALL

Anggota dwTotalSize dari struktur tidak menentukan cukup memori untuk memuat bagian tetap dari struktur yang ditentukan.

LINEERR_TARGETNOTFOUND

Target untuk handoff panggilan tidak ditemukan. Ini dapat terjadi jika aplikasi bernama tidak membuka baris yang sama dengan bit LINECALLPRIVILEGE_OWNER dalam parameter dwPrivilegeslineOpen. Atau, dalam kasus handoff mode media, tidak ada aplikasi yang telah membuka baris yang sama dengan bit LINECALLPRIVILEGE_OWNER dalam parameter dwPrivilegeslineOpen dan dengan jenis media yang ditentukan dalam parameter dwMediaMode yang telah ditentukan dalam parameter dwMediaModeslineOpen.

LINEERR_TARGETSELF

Aplikasi yang memanggil operasi ini adalah target handoff tidak langsung. Artinya, TAPI telah menentukan bahwa aplikasi panggilan juga merupakan aplikasi prioritas tertinggi untuk jenis media tertentu.

LINEERR_UNINITIALIZED

Operasi ini dipanggil sebelum aplikasi apa pun yang disebut lineInitialize atau lineInitializeEx.

LINEERR_USERCANCELLED

Pengguna membatalkan panggilan. Nilai ini hanya diekspos ke aplikasi yang menegosiasikan versi TAPI 2.2 atau yang lebih baru.

LINEERR_USERUSERINFOTOOBIG

String yang berisi informasi pengguna-pengguna melebihi jumlah maksimum byte yang ditentukan dalam dwUUIAcceptSize, dwUUIAnswerSize, dwUUIDropSize, dwUUIMakeCallSize, atau dwUUISendUserInfoSize anggota LINEDEVCAPS, atau string yang berisi informasi pengguna-pengguna terlalu panjang.

Keterangan

Nilai yang 0xC0000000 melalui 0xFFFFFFFF tersedia untuk ekstensi khusus perangkat. Nilai yang 0x80000000 melalui 0xBFFFFFFF dicadangkan, sementara 0x00000000 melalui 0x7FFFFFFF digunakan sebagai pengidentifikasi permintaan.

Jika aplikasi mendapatkan pengembalian kesalahan yang tidak ditangani secara khusus (seperti kesalahan yang ditentukan oleh ekstensi khusus perangkat), aplikasi harus memperlakukan kesalahan sebagai LINEERR_OPERATIONFAILED (karena alasan yang tidak ditentukan).

Saat memanggil LINEERR_constants yang baru dengan TAPI 3.0, file Tapierr.mc harus diperbarui dengan pesan baru.

Persyaratan

Persyaratan Nilai
Versi TAPI
Membutuhkan TAPI 2.0 atau yang lebih baru
Header
Tapi.h

Lihat juga

LINEADDRESSCAPS

LINEDEVCAPS

LINEDEVSTATUS

lineGetLineDevStatus

lineInitialize

lineInitializeEx

lineOpen

lineShutdown