Fungsi panggilan balik RasCustomDialDlgFn (rasdlg.h)

Artikel
03/01/2024

[Fungsi ini tidak tersedia pada Windows Server 2008.

]

Fungsi RasCustomDialDlg adalah fungsi yang ditentukan aplikasi yang diekspor oleh DLL panggilan kustom pihak ketiga. Fungsi ini memungkinkan vendor pihak ketiga untuk menerapkan kotak dialog koneksi RAS kustom.

Sintaks

RasCustomDialDlgFn Rascustomdialdlgfn;

BOOL Rascustomdialdlgfn(
  HINSTANCE hInstDll,
  DWORD dwFlags,
  LPWSTR lpszPhonebook,
  LPWSTR lpszEntry,
  LPWSTR lpszPhoneNumber,
  LPRASDIALDLG lpInfo,
  PVOID pvInfo
)
{...}

Parameter

hInstDll

Tangani ke instans DLL pemutaran kustom yang dimuat.

dwFlags

Sekumpulan bendera bit yang menentukan opsi RasCustomDialDlg .

Nilai	Makna
RCD_Logon	Jika bendera ini diatur ke satu, koneksi diputar dari konteks Masuk Windows. RasDial menggunakan informasi ini untuk mendapatkan preferensi pengguna yang sesuai untuk entri koneksi. Jika RasDial dipanggil dari titik masuk ini, anggota dwfOptions dari parameter lpRasDialExtension harus memiliki bendera RDEOPT_NoUser yang diatur untuk menunjukkan koneksi diputar dari konteks Masuk Windows.

Nilai

Makna

RCD_Logon

Jika bendera ini diatur ke satu, koneksi diputar dari konteks Masuk Windows. RasDial menggunakan informasi ini untuk mendapatkan preferensi pengguna yang sesuai untuk entri koneksi. Jika RasDial dipanggil dari titik masuk ini, anggota dwfOptions dari parameter lpRasDialExtension harus memiliki bendera RDEOPT_NoUser yang diatur untuk menunjukkan koneksi diputar dari konteks Masuk Windows.

Windows Server 2003 dan Windows XP/2000: Parameter ini dicadangkan dan tidak boleh digunakan.

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 .

lpszEntry

Penunjuk ke string yang dihentikan null yang berisi nama entri buku telepon untuk dial.

lpszPhoneNumber

Penunjuk ke string yang dihentikan null yang berisi nomor telepon yang menggantikan nomor yang disimpan dalam entri buku telepon. Jika parameter ini NULL, RasDialDlg menggunakan nomor dalam entri buku telepon.

lpInfo

Arahkan ke struktur RASDIALDLG yang berisi parameter input dan output tambahan. Pada input, anggota dwSize dari struktur ini harus menentukan sizeof( RASDIALDLG). Jika terjadi kesalahan, anggota dwError mengembalikan kode kesalahan; jika tidak, ia mengembalikan nol.

pvInfo

Dicadangkan untuk penggunaan internal. Parameter ini akan selalu NULL.

Mengembalikan nilai

Jika pengguna membuat, menyalin, atau mengedit entri buku telepon, nilai yang dikembalikan harus TRUE. Jika tidak, fungsi harus mengembalikan FALSE.

Jika terjadi kesalahan, RasCustomEntryDlg harus mengatur anggota dwError dari struktur RASENTRYDLG ke nilai dari Perutean dan Kode Kesalahan Akses Jarak Jauh atau Winerror.h.

Keterangan

RAS memanggil titik masuk ini dari RasDialDlg, 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 dwfOptions dari struktur RASDIALEXTENSIONS harus memiliki set bendera RDEOPT_CustomDial .

Dialog putar nomor kustom harus mendukung pesan WM_COMMAND di mana LOWORD(wParam) sama dengan IDCANCEL.

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

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	rasdlg.h