Fungsi panggilan balik RasCustomDialFn (ras.h)

Artikel
03/15/2023

[Fungsi ini tidak tersedia pada Windows Server 2008.

]

Fungsi RasCustomDial adalah fungsi yang ditentukan aplikasi yang diekspor oleh DLL panggilan kustom pihak ketiga. Fungsi ini memungkinkan vendor pihak ketiga untuk menerapkan rutinitas pemutaran akses jarak jauh kustom.

Sintaks

RasCustomDialFn Rascustomdialfn;

DWORD Rascustomdialfn(
  HINSTANCE hInstDll,
  LPRASDIALEXTENSIONS lpRasDialExtensions,
  LPCWSTR lpszPhonebook,
  LPRASDIALPARAMS lpRasDialParams,
  DWORD dwNotifierType,
  LPVOID lpvNotifier,
  LPHRASCONN lphRasConn,
  DWORD dwFlags
)
{...}

Parameter

hInstDll

Tangani ke instans DLL putar-nomor kustom yang dimuat.

lpRasDialExtensions

Arahkan ke struktur RASDIALEXTENSIONS yang menentukan serangkaian fitur yang diperluas RasDial untuk diaktifkan. Atur parameter ini ke NULL jika tidak perlu mengaktifkan ekstensi.

lpszPhonebook

Penunjuk ke string yang dihentikan null yang menentukan jalur lengkap dan nama file file buku telepon (PBK). Jika parameter ini NULL, fungsi menggunakan file buku telepon default saat ini. File buku telepon default adalah file yang dipilih oleh pengguna di lembar properti Preferensi Pengguna dari kotak dialog Jaringan Dial-Up .

lpRasDialParams

Penunjuk ke struktur RASDIALPARAMS yang menentukan parameter panggilan untuk koneksi RAS.

Pemanggil harus mengatur anggota dwSize struktur RASDIALPARAMS ke sizeof (RASDIALPARAMS) untuk mengidentifikasi versi struktur yang diteruskan.

dwNotifierType

Parameter ini sama dengan parameter dwNotifierType untuk fungsi RasDial . Lihat halaman referensi RasDial untuk informasi selengkapnya.

lpvNotifier

Parameter ini sama dengan parameter lpvNotifier untuk fungsi RasDial . Lihat halaman referensi RasDial untuk informasi selengkapnya.

lphRasConn

Penunjuk ke variabel jenis HRASCONN. Atur variabel HRASCONN ke NULL sebelum memanggil RasDial. Jika RasDial berhasil, RasDial menyimpan handel ke koneksi RAS ke dalam *lphRasConn.

dwFlags

Parameter ini dicadangkan untuk digunakan di masa mendatang.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan ERROR_SUCCESS dan handel ke koneksi RAS dalam variabel yang diarahkan oleh parameter lphRasConn dikembalikan.

Jika fungsi gagal, nilai yang dikembalikan adalah salah satu kode kesalahan berikut atau nilai dari Kode Kesalahan Perutean dan Akses Jarak Jauh atau Winerror.h.

Nilai	Makna
ERROR_NOT_ENOUGH_MEMORY	Fungsi tidak dapat mengalokasikan memori yang cukup untuk menyelesaikan operasi.

Keterangan

RAS memanggil titik masuk ini dari RasDial, jika anggota szCustomDialDll dari struktur RASENTRY untuk entri yang dihubungi menentukan DLL panggilan kustom.

Jika titik masuk ini memanggil RasDial, parameter lpRasDialExtensions tidak boleh NULL, dan anggota dwFlags dari struktur RASDIALEXTENSIONS harus memiliki set bendera RDEOPT_CustomDial.

Jika DLL putar-nomor kustom tidak mendukung titik masuk ini, RAS mengembalikan ERROR_CANNOT_DO_CUSTOMDIAL ke pemanggil RasDial.

Persyaratan


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