Fungsi RasSetSubEntryPropertiesA (ras.h)

Artikel
08/25/2023

Fungsi RasSetSubEntryProperties membuat subentry baru atau memodifikasi subentri yang ada dari entri buku telepon tertentu.

Sintaks

DWORD RasSetSubEntryPropertiesA(
  [in] LPCSTR         unnamedParam1,
  [in] LPCSTR         unnamedParam2,
  [in] DWORD          unnamedParam3,
  [in] LPRASSUBENTRYA unnamedParam4,
  [in] DWORD          unnamedParam5,
  [in] LPBYTE         unnamedParam6,
  [in] DWORD          unnamedParam7
);

Parameter

[in] unnamedParam1

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 .

Windows Me/98/95: Parameter ini harus selalu NULL. Jaringan dial-up menyimpan entri buku telepon dalam registri, bukan dalam file buku telepon.

[in] unnamedParam2

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

[in] unnamedParam3

Menentukan indeks subentri berbasis satu. Jika indeks cocok dengan indeks subentri yang ada, fungsi akan mengubah properti subentri tersebut. Jika indeks tidak cocok dengan indeks yang ada, fungsi akan membuat subentry baru.

[in] unnamedParam4

Arahkan ke struktur RASSUBENTRY yang menentukan data untuk subentry.

Struktur mungkin diikuti oleh array string nomor telepon alternatif yang dihentikan null. String terakhir dihentikan oleh dua karakter null berturut-turut. Anggota dwAlternateOffset dari struktur RASSUBENTRY berisi offset ke string pertama.

[in] unnamedParam5

Menentukan ukuran, dalam byte, dari buffer lpRasSubEntry .

[in] unnamedParam6

Pointer ke blok konfigurasi perangkat TAPI. Parameter ini saat ini tidak digunakan. Pemanggil harus meneruskan NULL untuk parameter ini. Untuk informasi selengkapnya tentang blok konfigurasi perangkat TAPI, lihat fungsi lineGetDevConfig.

[in] unnamedParam7

Menentukan ukuran blok konfigurasi perangkat TAPI. Parameter ini saat ini tidak digunakan. Pemanggil harus melewati nol untuk parameter ini.

Mengembalikan nilai

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.

Nilai	Makna
ERROR_BUFFER_INVALID	Alamat atau buffer yang ditentukan oleh lpRasEntry tidak valid.
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY	Entri buku telepon tidak ada.
ERROR_CANNOT_OPEN_PHONEBOOK	Buku telepon rusak atau komponen hilang.
ERROR_INVALID_PARAMETER	Fungsi ini dipanggil dengan parameter yang tidak valid.

Keterangan

Entri buku telepon RAS dapat memiliki nol atau lebih subentri, masing-masing minimal terdiri dari perangkat dan nomor telepon. Entri buku telepon dengan beberapa subentri dapat dikonfigurasi untuk memutar nomor subentri pertama yang tersedia atau semua subentri saat entri diputar.

Gunakan fungsi RasGetEntryProperties untuk mengambil struktur RASENTRY yang berisi informasi tentang subentri entri buku telepon. Anggota dwSubEntries menunjukkan jumlah subentri dan anggota dwDialMode menunjukkan konfigurasi panggilan.

Catatan

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

Lihat juga

RASENTRY

RASSUBENTRY

RasGetEntryProperties

Gambaran Umum Layanan Akses Jarak Jauh (RAS)

Fungsi Layanan Akses Jarak Jauh