fungsi tapiRequestMakeCall (tapi.h)

  • Artikel

Fungsi tapiRequestMakeCall meminta pembentukan panggilan suara. Aplikasi pengelola panggilan bertanggung jawab untuk membuat panggilan atas nama aplikasi yang meminta, yang kemudian dikendalikan oleh aplikasi pengelola panggilan pengguna.

Sintaks

LONG tapiRequestMakeCall(
  LPCSTR lpszDestAddress,
  LPCSTR lpszAppName,
  LPCSTR lpszCalledParty,
  LPCSTR lpszComment
);

Parameter

lpszDestAddress

Penunjuk ke lokasi memori tempat alamat tujuan permintaan panggilan yang dihentikan null berada. Alamat dapat menggunakan format alamat kanonis . Validitas alamat yang ditentukan tidak diperiksa oleh operasi ini. Panjang maksimum alamat adalah karakter TAPIMAXDESTADDRESSSIZE, yang mencakup terminator NULL .

lpszAppName

Penunjuk ke lokasi memori tempat nama aplikasi ramah pengguna yang dihentikan null dari permintaan panggilan berada. Pointer ini dapat dibiarkan NULL jika aplikasi tidak menyediakan nama aplikasi. Panjang maksimum alamat adalah karakter TAPIMAXAPPNAMESIZE, yang mencakup terminator NULL . String yang lebih panjang dipotong.

lpszCalledParty

Penunjuk ke lokasi memori di mana nama pihak yang dihentikan null untuk pihak panggilan yang dipanggil berada. Pointer ini dapat dibiarkan NULL jika aplikasi tidak ingin memberikan informasi ini. Panjang maksimum string adalah karakter TAPIMAXCALLEDPARTYSIZE, yang mencakup terminator NULL . String yang lebih panjang dipotong.

lpszComment

Arahkan ke lokasi memori tempat komentar null-dihentikan tentang panggilan berada. Pointer ini dapat dibiarkan NULL jika aplikasi tidak memberikan komentar. Panjang maksimum alamat adalah karakter TAPIMAXCOMMENTSIZE, yang mencakup terminator NULL . String yang lebih panjang dipotong.

Mengembalikan nilai

Mengembalikan nol jika permintaan berhasil atau angka kesalahan negatif jika terjadi kesalahan. Kemungkinan nilai pengembalian kesalahan adalah:

TAPIERR_NOREQUESTRECIPIENT, TAPIERR_INVALDESTADDRESS, TAPIERR_REQUESTQUEUEFULL, TAPIERR_INVALPOINTER.

Keterangan

Aplikasi dengan dukungan telepon dapat meminta agar panggilan dilakukan atas namanya dengan memanggil tapiRequestMakeCall, hanya menyediakan alamat tujuan untuk panggilan. Permintaan ini diteruskan ke aplikasi kontrol panggilan pengguna, yang menempatkan panggilan atas nama aplikasi asli. Aplikasi kontrol panggilan default disediakan sebagai bagian dari Telepon. Pengguna dapat mengganti ini dengan aplikasi kontrol panggilan pilihan mereka.

Memanggil tapiRequestMakeCall ketika tidak ada aplikasi kontrol panggilan yang berjalan mengembalikan indikasi kesalahan TAPIERR_NOREQUESTRECIPIENT. Jika aplikasi kontrol panggilan tidak berjalan, TAPI mencoba meluncurkan aplikasi kontrol panggilan berprioritas tertinggi (yang tercantum untuk RequestMakeCall di registri). Memanggil fungsi ini ketika antrean permintaan TAPI Terbantu penuh mengembalikan kesalahan TAPIERR_REQUESTQUEUEFULL.

Persyaratan

Persyaratan Nilai
Target Platform Windows
Header tapi.h
Pustaka Tapi32.lib
DLL Tapi32.dll

Lihat juga

Referensi Layanan Telepon Terbantu

Gambaran Umum Referensi TAPI 2.2