Fungsi RasEditPhonebookEntryA (ras.h)

Artikel
03/04/2024

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

Fungsi RasEditPhonebookEntry mengedit entri buku telepon yang ada. Fungsi menampilkan kotak dialog di mana pengguna dapat mengubah informasi yang ada.

Sintaks

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

Parameter

[in] unnamedParam1

Tangani ke jendela induk kotak dialog.

[in] unnamedParam2

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 .

[in] unnamedParam3

Penunjuk ke string yang dihentikan null yang menentukan nama entri yang ada dalam file buku telepon.

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_BUFFER_INVALID	Buffer entri buku telepon tidak valid.
ERROR_CANNOT_OPEN_PHONEBOOK	Buku telepon rusak atau komponen hilang.
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY	Entri buku telepon tidak ada.

Keterangan

Saat memanggil RasEntryDlg, atur setiap anggota struktur RASENTRYDLG yang diteruskan ke lpinfo ke nol kecuali:

dwSize = sizeof(RASENTRYDLG)
hwndOwner = parameter hwnd di atas

Catatan

Header ras.h mendefinisikan RasEditPhonebookEntry sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosedur 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

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