Fungsi RasSetAutodialAddressA (ras.h)

Fungsi RasSetAutodialAddress dapat menambahkan alamat ke database pemetaan AutoDial. Atau, fungsi ini dapat menghapus atau memodifikasi data yang terkait dengan alamat yang ada dalam database.

Sintaks

DWORD RasSetAutodialAddressA(
  [in] LPCSTR              unnamedParam1,
  [in] DWORD               unnamedParam2,
  [in] LPRASAUTODIALENTRYA unnamedParam3,
  [in] DWORD               unnamedParam4,
  [in] DWORD               unnamedParam5
);

Parameter

[in] unnamedParam1

Penunjuk ke string yang dihentikan null yang menentukan alamat untuk menambahkan, menghapus, atau memodifikasi. Alamat ini dapat berupa alamat IP, nama host Internet ("www.microsoft.com"), atau nama NetBIOS ("products1").

Jika parameter ini NULL, fungsi mengatur koneksi Internet default (lihat Keterangan). Jika parameter ini menunjuk ke string panjang nol, fungsi akan menghapus koneksi Internet default.

[in] unnamedParam2

Dipesan; harus nol.

[in] unnamedParam3

Penunjuk ke array dari satu atau beberapa struktur RASAUTODIALENTRY yang akan dikaitkan dengan alamat lpszAddress . Jika lpAutoDialEntries adalah NULL dan dwcbAutoDialEntries nol, RasSetAutodialAddress menghapus semua struktur yang terkait dengan lpszAddress dari database pemetaan.

[in] unnamedParam4

Menentukan ukuran, dalam byte, dari buffer lpAutoDialEntries .

[in] unnamedParam5

Menentukan jumlah struktur RASAUTODIALENTRY dalam buffer lpAutoDialEntries .

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_INVALID_SIZE	Anggota dwSize dari struktur RASAUTODIALENTRY adalah nilai yang tidak valid.
ERROR_INVALID_PARAMETER	Parameter lpszAddress adalah NULL.
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY	Nama koneksi yang ditentukan dalam lpAutoDialEntries tidak ada.

Keterangan

Alamat dalam database pemetaan AutoDial dapat memiliki sejumlah entri RASAUTODIALENTRY terkait. Setiap entri menentukan informasi AutoDial untuk lokasi pemutaran TAPI tertentu.

Jika alamat yang ditentukan oleh parameter lpszAddress adalah alamat yang ada dalam database dan parameter lpAutoDialEntries bukan NULL, fungsi RasSetAutodialAddress memodifikasi kumpulan entri AutoDial yang terkait dengan alamat. Jika entri dalam array lpAutoDialEntries menentukan lokasi pemutaran yang alamatnya sudah memiliki entri, fungsi mengganti entri yang ada dengan entri baru. Jika tidak, fungsi ini hanya menambahkan entri lpAutoDialEntries ke kumpulan entri untuk alamat.

Jika alamat lpszAddress ada di database, lpAutoDialEntries adalah NULL, dan lpAutoDialEntries adalah nol, RasSetAutodialAddress menghapus alamat dari database.

Jika alamat lpszAddress tidak ada di database, RasSetAutodialAddress menambahkan alamat ke database. Parameter lpAutoDialEntries menentukan entri AutoDial untuk dikaitkan dengan alamat baru.

RAS mendukung koneksi Internet default yang global ke komputer lokal dan mendukung koneksi Internet default untuk setiap pengguna.

Ketika parameter lpszAddress adalah NULL, dan parameter lpAutoDialEntries menentukan nama koneksi dengan satu entri, RasSetAutodialAddress mengatur koneksi sebagai koneksi internet default. Nama koneksi yang ditentukan dalam lpAutoDialEntries harus sudah ada. Jika tidak, ERROR_CANNOT_FIND_PHONEBOOK_ENTRY akan dikembalikan.

Ketika parameter lpszAddress adalah string panjang nol dan parameter lpAutoDialEntries menentukan nama koneksi kosong dengan satu entri, RasSetAutodialAddress menghapus koneksi internet default.

Pada komputer klien non-domain, jika pengguna ingin mengatur koneksi sebagai koneksi internet default dan menentukan koneksi "untuk semua pengguna" dalam anggota szEntry dari struktur RASAUTODIALENTRY , maka koneksi internet default diatur secara global di komputer lokal. Dalam semua kasus lain, koneksi internet default diatur untuk setiap pengguna komputer satu per satu.

Dimungkinkan untuk memiliki dua koneksi yang memiliki nama yang sama jika satu dikonfigurasi sebagai koneksi "untuk semua pengguna" dan yang lainnya dikonfigurasi sebagai koneksi "untuk-saya-saja". Jika parameter lpAutoDialEntries menentukan nama koneksi yang sesuai dengan koneksi global dan per pengguna, koneksi per pengguna diatur.

Catatan

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

RASAUTODIALENTRY

RasEnumAutodialAddresses

RasGetAutodialAddress

Gambaran Umum Layanan Akses Jarak Jauh (RAS)

Fungsi Layanan Akses Jarak Jauh