Fungsi panggilan balik RasCustomEntryDlgFn (rasdlg.h)

Artikel
08/25/2023

Fungsi RasCustomEntryDlg adalah fungsi yang ditentukan aplikasi yang diekspor oleh DLL panggilan kustom pihak ketiga. Fungsi ini memungkinkan vendor pihak ketiga untuk menerapkan dialog kustom untuk mengelola entri buku telepon.

Sintaks

RasCustomEntryDlgFn Rascustomentrydlgfn;

BOOL Rascustomentrydlgfn(
  HINSTANCE hInstDll,
  LPWSTR lpszPhonebook,
  LPWSTR lpszEntry,
  LPRASENTRYDLG lpInfo,
  DWORD dwFlags
)
{...}

Parameter

hInstDll

Tangani ke instans DLL putar-nomor kustom yang dimuat.

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 mengedit, menyalin, atau membuat.

Jika Anda mengedit atau menyalin entri, parameter ini adalah nama entri buku telepon yang ada. Jika Anda menyalin entri, atur bendera RASEDFLAG_CloneEntry di anggota dwFlags dari struktur RASENTRYDLG .

Jika Anda membuat entri, parameter ini adalah nama entri baru default yang dapat diubah pengguna. Jika parameter ini NULL, fungsi menyediakan nama default. Jika Anda membuat entri, atur bendera RASEDFLAG_NewEntry di anggota dwFlags dari struktur RASENTRYDLG .

lpInfo

Arahkan ke struktur RASENTRYDLG yang berisi parameter input dan output tambahan. Pada input, anggota dwSize dari struktur ini harus menentukan sizeof( RASENTRYDLG). Gunakan anggota dwSize untuk menunjukkan apakah membuat, mengedit, atau menyalin entri. Jika terjadi kesalahan, anggota dwError mengembalikan kode kesalahan; jika tidak, ia mengembalikan nol.

dwFlags

Disiapkan untuk penggunaan masa mendatang.

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 RasEntryDlg, jika anggota szCustomDialDll dari struktur RASENTRY untuk entri yang dipanggil menentukan DLL panggilan kustom.

Jika DLL dial kustom tidak mendukung titik masuk ini, RAS mengembalikan ERROR_NO_CUSTOMENTRYDLG ke pemanggil RasEntryDlg.

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