Fungsi panggilan balik RASDIALFUNC (ras.h)

Artikel
03/01/2024

Fungsi panggilan balik RasDialFunc dipanggil oleh fungsi RasDial ketika perubahan status terjadi selama proses koneksi RAS.

Sintaks

RASDIALFUNC Rasdialfunc;

void Rasdialfunc(
  UINT unnamedParam1,
  tagRASCONNSTATE unnamedParam2,
  DWORD unnamedParam3
)
{...}

Parameter

unnamedParam1

unnamedParam2

unnamedParam3

Nilai kembali

Tidak ada

Keterangan

Operasi koneksi RasDial ditangguhkan selama panggilan ke fungsi panggilan balik RasDialFunc . Untuk itu, implementasi RasDialFunc umumnya harus kembali secepat mungkin. Ada dua pengecualian untuk aturan itu. Perangkat asinkron (lambat) seperti modem sering memiliki periode waktu habis yang diukur dalam hitungan detik daripada milidetik; pengembalian lambat dari fungsi RasDialFunc umumnya tidak menjadi masalah. Persyaratan pengembalian prompt juga tidak berlaku ketika dwError bukan nol, menunjukkan bahwa kesalahan telah terjadi. Aman, misalnya, untuk memasang kotak dialog kesalahan dan menunggu input pengguna.

Implementasi RasDialFunc tidak boleh bergantung pada urutan atau terjadinya status koneksi RASCONNSTATE tertentu, karena ini dapat bervariasi di antara platform.

Jangan panggil fungsi RasDial dari dalam fungsi panggilan balik RasDialFunc . Panggil fungsi RasGetConnectStatus, RasEnumEntries, RasEnumConnections, RasGetErrorString, dan RasHangUp dari dalam fungsi panggilan balik. Misalnya, memanggil RasGetConnectStatus dari dalam fungsi panggilan balik akan berguna untuk menentukan nama dan jenis perangkat penghubung.

Catatan Untuk kenyamanan, RasHangUp dapat dipanggil dari dalam fungsi panggilan balik RasDialFunc . Namun, sebagian besar pemrosesan hang-up terjadi setelah fungsi panggilan balik RasDialFunc kembali.

CatatanRasDialFunc adalah tempat penampung untuk nama fungsi yang ditentukan aplikasi atau yang ditentukan pustaka.

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