Fungsi RasSetAutodialParamA (ras.h)

  • Artikel

Fungsi RasSetAutodialParam menetapkan nilai parameter AutoDial.

Sintaks

DWORD RasSetAutodialParamA(
  [in]  DWORD  unnamedParam1,
  [out] LPVOID unnamedParam2,
  [in]  DWORD  unnamedParam3
);

Parameter

[in] unnamedParam1

Menentukan parameter AutoDial yang akan diatur. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai Makna
RASADP_DisableConnectionQuery
 Parameter lpvValue menunjuk ke nilai DWORD . Jika nilai ini nol (default), AutoDial menampilkan kotak dialog untuk mengkueri pengguna sebelum membuat koneksi. Jika nilai ini adalah satu, dan database AutoDial memiliki entri buku telepon untuk dial, AutoDial membuat koneksi tanpa menampilkan kotak dialog.
RASADP_LoginSessionDisable
 Parameter lpvValue menunjuk ke nilai DWORD . Jika nilai ini adalah satu, sistem menonaktifkan semua koneksi AutoDial untuk sesi masuk saat ini. Jika nilai ini nol (default), koneksi AutoDial diaktifkan. Layanan sistem AutoDial mengubah nilai ini menjadi nol ketika pengguna baru masuk ke stasiun kerja.
RASADP_SavedAddressesLimit
 Parameter lpvValue menunjuk ke nilai DWORD yang menunjukkan jumlah maksimum alamat yang disimpan AutoDial dalam registri. AutoDial pertama-tama menyimpan alamat yang digunakan untuk membuat koneksi AutoDial; kemudian menyimpan alamat yang dipelajarinya setelah koneksi RAS dibuat. Alamat yang ditulis menggunakan fungsi RasSetAutodialAddress selalu disimpan, dan tidak termasuk dalam menghitung batas. Nilai defaultnya adalah 100.
RASADP_FailedConnectionTimeout
 Parameter lpvValue menunjuk ke nilai DWORD yang menunjukkan nilai waktu habis, dalam hitungan detik. Ketika upaya koneksi AutoDial gagal, layanan sistem AutoDial menonaktifkan upaya berikutnya untuk mencapai alamat yang sama untuk periode waktu habis. Ini mencegah AutoDial menampilkan beberapa kotak dialog koneksi untuk permintaan logis yang sama oleh aplikasi. Nilai defaultnya adalah lima.
RASADP_ConnectionQueryTimeout
 Parameter lpvValue menunjuk ke nilai DWORD yang menunjukkan nilai waktu habis, dalam hitungan detik. Sebelum mencoba koneksi AutoDial, sistem akan menampilkan dialog yang meminta pengguna untuk mengonfirmasi bahwa sistem harus melakukan panggilan. Dialog memiliki timer hitung mundur yang mengakhiri dialog dengan pilihan "Jangan putar" jika pengguna tidak mengambil tindakan. Nilai DWORD yang diacu oleh lpvValue menentukan waktu awal pada timer hitung mundur ini.

[out] unnamedParam2

Penunjuk ke buffer yang berisi nilai baru untuk parameter yang ditentukan.

[in] unnamedParam3

Menentukan ukuran, dalam byte, dari nilai dalam buffer lpvValue .

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.

Nilai Makna
ERROR_INVALID_PARAMETER
 Parameter dwKey atau lpvValue tidak valid.
ERROR_INVALID_SIZE
 Ukuran yang ditentukan oleh dwcbValue tidak valid.

Keterangan

Catatan

Header ras.h mendefinisikan RasSetAutodialParam 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

RasGetAutodialParam

RasSetAutodialAddress

Gambaran Umum Layanan Akses Jarak Jauh (RAS)

Fungsi Layanan Akses Jarak Jauh