Fungsi RasGetAutodialAddressA (ras.h)

  • Artikel

Fungsi RasGetAutodialAddress mengambil informasi tentang semua entri AutoDial yang terkait dengan alamat jaringan dalam database pemetaan AutoDial.

Sintaks

DWORD RasGetAutodialAddressA(
  [in]      LPCSTR              unnamedParam1,
  [in]      LPDWORD             unnamedParam2,
  [in, out] LPRASAUTODIALENTRYA unnamedParam3,
  [in, out] LPDWORD             unnamedParam4,
  [out]     LPDWORD             unnamedParam5
);

Parameter

[in] unnamedParam1

Penunjuk ke string yang dihentikan null yang menentukan alamat yang informasinya diminta. Ini bisa berupa alamat IP, nama host Internet ("www.microsoft.com"), atau nama NetBIOS ("products1").

Jika parameter ini NULL, fungsi mengambil koneksi Internet default. Fungsi mengembalikan koneksi Internet default per pengguna jika dikonfigurasi. Jika tidak, fungsi mengembalikan koneksi Internet default global. Jika tidak ada koneksi Internet default yang dikonfigurasi, fungsi mengembalikan nol untuk parameter lpdwcbAutoDialEntries dan lpdwcAutoDialEntries .

[in] unnamedParam2

Dipesan; harus NULL.

[in, out] unnamedParam3

Pointer ke buffer yang, pada output, menerima array struktur RASAUTODIALENTRY , satu untuk setiap entri AutoDial yang terkait dengan alamat yang ditentukan oleh parameter lpszAddress .

Pada input, atur anggota dwSize dari struktur RASAUTODIALENTRY pertama dalam buffer ke sizeof (RASAUTODIALENTRY) untuk mengidentifikasi versi struktur.

Jika lpAutoDialEntriesADALAH NULL, RasGetAutodialAddress mengatur parameter lpdwcbAutoDialEntries dan lpdwcAutoDialEntries untuk menunjukkan ukuran buffer yang diperlukan, dalam byte, dan jumlah entri AutoDial.

[in, out] unnamedParam4

Penunjuk ke variabel yang, pada input, menentukan ukuran, dalam byte, dari buffer lpAutoDialEntries .

Pada output, variabel ini menerima jumlah byte yang dikembalikan, atau jumlah byte yang diperlukan jika buffer terlalu kecil.

[out] unnamedParam5

Penunjuk ke variabel yang menerima jumlah elemen struktur yang dikembalikan 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, lpdwcbAutoDialEntries, atau lpdwcAutoDialEntries adalah NULL.

Keterangan

Layanan Akses Jarak Jauh (RAS) mendukung koneksi Internet default. RAS mendukung koneksi Internet default yang bersifat global ke komputer lokal, dan sebagai tambahan, mendukung koneksi Internet default untuk setiap pengguna.

Nama koneksi Internet default global disimpan dalam registri di bawah kunci registri berikut:

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Ras Autodial
            Default

Nilai yang menyimpan nama koneksi adalah:

DefaultInternet

Nilai ini berjenis REG_SZ.

Koneksi Internet default global harus dikonfigurasi sebagai koneksi Untuk semua pengguna di antarmuka pengguna folder Connections.

Nama koneksi Internet default per pengguna disimpan dalam registri di bawah kunci registri berikut:

\ HKEY_CURRENT_USERPerangkat lunak\Microsoft\Putar Otomatis\ RasDefault

Nilai yang menyimpan nama koneksi adalah:

DefaultInternet

Nilai ini berjenis REG_SZ.

Catatan

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

RasSetAutodialAddress

Gambaran Umum Layanan Akses Jarak Jauh (RAS)

Fungsi Layanan Akses Jarak Jauh