RASDIALFUNC1 fungsi panggilan balik (ras.h)

Artikel
03/04/2024

Fungsi RasDialFunc1 dipanggil oleh fungsi RasDial ketika perubahan status terjadi selama proses koneksi akses jarak jauh. Fungsi RasDialFunc1 sebanding dengan fungsi RasDialFunc , tetapi ditingkatkan dengan penambahan dua parameter: handel ke koneksi RAS, dan kode kesalahan yang diperluas.

Sintaks

RASDIALFUNC1 Rasdialfunc1;

void Rasdialfunc1(
  HRASCONN unnamedParam1,
  UINT unnamedParam2,
  tagRASCONNSTATE unnamedParam3,
  DWORD unnamedParam4,
  DWORD unnamedParam5
)
{...}

Parameter

unnamedParam1

unnamedParam2

unnamedParam3

unnamedParam4

unnamedParam5

Nilai kembali

Tidak ada

Keterangan

Operasi koneksi RasDial ditangguhkan selama panggilan ke fungsi panggilan balik RasDialFunc1 . Untuk itu, implementasi RasDialFunc1 umumnya 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 RasDialFunc1 umumnya bukan 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 RasDialFunc1 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 RasDialFunc1 . 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.

Perhatikan bahwa, untuk kenyamanan, RasHangUp dapat dipanggil dari dalam fungsi panggilan balik RasDialFunc1 . Namun, sebagian besar pemrosesan hang-up terjadi setelah fungsi panggilan balik RasDialFunc1 telah kembali.

RasDialFunc1 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