Fungsi panggilan balik RASADFUNCA (ras.h)

Fungsi RASADFunc adalah fungsi panggilan balik yang ditentukan aplikasi yang digunakan untuk menyediakan antarmuka pengguna yang disesuaikan untuk autodialing.

Sintaks

RASADFUNCA Rasadfunca;

BOOL Rasadfunca(
  LPSTR unnamedParam1,
  LPSTR unnamedParam2,
  LPRASADPARAMS unnamedParam3,
  LPDWORD unnamedParam4
)
{...}

Parameter

unnamedParam1

unnamedParam2

unnamedParam3

unnamedParam4

Nilai kembali

Jika aplikasi melakukan operasi putar nomor, kembalikan TRUE. Gunakan parameter lpdwRetCode untuk menunjukkan hasil operasi panggilan.

Jika aplikasi tidak melakukan operasi putar nomor, kembalikan FALSE. Dalam hal ini, sistem menggunakan antarmuka pengguna default untuk memutar nomor.

Keterangan

Ketika sistem memulai operasi AutoDial untuk entri buku telepon dengan handler AutoDial kustom, sistem memanggil RASADFunc yang ditentukan. RASADFunc dapat memulai utas untuk melakukan operasi putar-nomor kustom. Fungsi RASADFunc mengembalikan TRUE untuk menunjukkan bahwa dibutuhkan lebih dari panggilan, atau FALSE untuk memungkinkan sistem melakukan panggilan.

Jika fungsi RASADFunc melakukan operasi putar nomor, fungsi ini menyajikan antarmuka penggunanya sendiri untuk memutar nomor dan memanggil fungsi RasDial untuk melakukan panggilan aktual. RASADFunc kemudian mengembalikan TRUE untuk menunjukkan bahwa ia mengambil alih panggilan. Ketika operasi putar nomor telah selesai, atur variabel yang ditunjukkan oleh parameter lpdwRetCode untuk menunjukkan keberhasilan atau kegagalan.

DLL AutoDial harus menyediakan RASADFUNCA (ANSI) dan versi RASADFUNCW (Unicode) dari handler RASADFunc . Untuk mengaktifkan handler RASADFunc AutoDial untuk entri buku telepon, gunakan struktur RASENTRY dalam panggilan ke fungsi RasSetEntryProperties . Anggota szAutodialDll menentukan nama DLL yang berisi handler, dan anggota szAutodialFunc menentukan nama handler yang diekspor. Anggota szAutodialFunc tidak boleh menyertakan akhiran "A" atau "W".

RASADFunc adalah tempat penampung untuk nama fungsi yang ditentukan pustaka. Jenis RASADFUNC adalah penunjuk ke fungsi RASADFunc .

Catatan

Header ras.h mendefinisikan RASADFUNC sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Target Platform Windows
Header ras.h

Lihat juga

RASENTRY

RasDial

RasSetEntryProperties

Gambaran Umum Layanan Akses Jarak Jauh (RAS)

Fungsi Layanan Akses Jarak Jauh