RASDIALFUNC2 fungsi panggilan balik (ras.h)

Artikel
03/01/2024

Fungsi panggilan balik RasDialFunc2 dipanggil oleh fungsi RasDial memanggil ketika perubahan status terjadi selama proses koneksi akses jarak jauh. Fungsi RasDialFunc2 mirip dengan fungsi panggilan balik RasDialFunc1 , kecuali bahwa fungsi ini menyediakan informasi tambahan untuk koneksi multilink.

Sintaks

RASDIALFUNC2 Rasdialfunc2;

DWORD Rasdialfunc2(
  ULONG_PTR unnamedParam1,
  DWORD unnamedParam2,
  HRASCONN unnamedParam3,
  UINT unnamedParam4,
  tagRASCONNSTATE unnamedParam5,
  DWORD unnamedParam6,
  DWORD unnamedParam7
)
{...}

Parameter

unnamedParam1

unnamedParam2

unnamedParam3

unnamedParam4

unnamedParam5

unnamedParam6

unnamedParam7

Nilai kembali

Jika fungsi RasDialFunc2 mengembalikan nilai bukan nol, RasDial terus mengirim pemberitahuan panggilan balik.

Jika fungsi RasDialFunc2 mengembalikan nol, RasDial akan berhenti mengirim pemberitahuan panggilan balik untuk semua subentri.

Keterangan

Operasi koneksi RasDial ditangguhkan selama panggilan ke fungsi panggilan balik RasDialFunc2 . Untuk alasan itu, implementasi RasDialFunc2 umumnya mengembalikan 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 RasDialFunc2 umumnya tidak menjadi masalah. Persyaratan pengembalian prompt juga tidak berlaku ketika dwError bukan nol, menunjukkan bahwa telah terjadi kesalahan. Aman, misalnya, untuk memasang kotak dialog kesalahan dan menunggu input pengguna.

Implementasi RasDialFunc2 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 RasDialFunc2 . 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 RasDialFunc2 . Namun, sebagian besar pemrosesan hang-up terjadi setelah fungsi panggilan balik RasDialFunc2 telah kembali.

CatatanRasDialFunc2 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