Fungsi RasCreatePhonebookEntryA (ras.h)

Artikel
03/15/2023

[Fungsi ini tidak digunakan lagi pada Windows Vista dan fungsinya telah digantikan oleh RasDialDlg. ]

Fungsi RasCreatePhonebookEntry membuat entri buku telepon baru. Fungsi menampilkan kotak dialog tempat pengguna mengetik informasi untuk entri buku telepon.

Sintaks

DWORD RasCreatePhonebookEntryA(
  [in] HWND   unnamedParam1,
  [in] LPCSTR unnamedParam2
);

Parameter

[in] unnamedParam1

Tangani ke jendela induk kotak dialog.

[in] unnamedParam2

Penunjuk ke string yang dihentikan null yang menentukan jalur lengkap dan nama file dari file buku telepon (PBK). Jika parameter ini ADALAH 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 .

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS.

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.

Menampilkan kode	Deskripsi
ERROR_CANNOT_OPEN_PHONEBOOK	Buku telepon rusak atau komponen hilang.

Keterangan

Saat memanggil RasDialDlg, atur setiap anggota struktur RASDIALDLG yang diteruskan ke lpInfo ke nol kecuali:

dwSize = sizeof(RASDIALDLG)
hwndOwner = parameter hwnd di atas
dwFlags = RASEDFLAG_NewEntry

Catatan

Header ras.h mendefinisikan RasCreatePhonebookEntry sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

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
Pustaka	Rasapi32.lib
DLL	Rasapi32.dll