Fungsi RasGetAutodialParamA (ras.h)

  • Artikel

Fungsi RasGetAutodialParam mengambil nilai parameter AutoDial.

Sintaks

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

Parameter

[in] unnamedParam1

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

Nilai Makna
RASADP_DisableConnectionQuery
 Parameter lpvValue mengembalikan nilai DWORD . Jika nilai ini nol (default), AutoDial menampilkan kotak dialog untuk mengkueri pengguna sebelum membuat koneksi. Jika nilai ini adalah 1, dan database AutoDial memiliki entri buku telepon untuk dial, AutoDial membuat koneksi tanpa menampilkan kotak dialog.
RASADP_LoginSessionDisable
 Parameter lpvValue mengembalikan nilai DWORD . Jika nilai ini adalah 1, 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 mengembalikan nilai DWORD yang menunjukkan jumlah maksimum alamat yang disimpan AutoDial dalam registri. AutoDial pertama-tama menyimpan alamat yang digunakannya 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 mengembalikan 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 5.
RASADP_ConnectionQueryTimeout
 Parameter lpvValue menunjuk ke nilai DWORD yang menunjukkan nilai waktu habis, dalam hitungan detik. Sebelum mencoba sambungan Otomatis, sistem akan menampilkan dialog yang meminta pengguna untuk mengonfirmasi bahwa sistem harus memanggil nomor. Dialog memiliki timer hitung mundur yang mengakhiri dialog dengan pilihan "Jangan putar nomor" jika pengguna tidak mengambil tindakan. Nilai DWORD yang ditujukkan oleh lpvValue menentukan waktu awal pada timer hitung mundur ini.

[out] unnamedParam2

Penunjuk ke buffer yang menerima nilai untuk parameter yang ditentukan.

[in, out] unnamedParam3

Penunjuk ke nilai DWORD .

Pada input, atur nilai ini untuk menunjukkan ukuran, dalam byte, dari buffer lpvValue .

Pada output, nilai ini menunjukkan ukuran aktual dari nilai yang ditulis ke buffer.

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 lpdwcbValue terlalu kecil.

Keterangan

Catatan

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

RasSetAutodialAddress

RasSetAutodialParam

Gambaran Umum Layanan Akses Jarak Jauh (RAS)

Fungsi Layanan Akses Jarak Jauh