Fungsi InternetDialA (wininet.h)

Artikel
03/09/2024

Memulai sambungan ke Internet menggunakan modem.

Sintaks

DWORD InternetDialA(
  [in]  HWND      hwndParent,
  [in]  LPSTR     lpszConnectoid,
  [in]  DWORD     dwFlags,
  [out] DWORD_PTR *lpdwConnection,
  [in]  DWORD     dwReserved
);

Parameter

[in] hwndParent

Tangani ke jendela induk.

[in] lpszConnectoid

Penunjuk ke string yang dihentikan null yang menentukan nama koneksi dial-up yang akan digunakan. Jika parameter ini berisi string kosong (""), pengguna akan memilih koneksi. Jika parameter ini NULL, fungsi akan tersambung ke koneksi otomatis.

[in] dwFlags

Opsi. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
INTERNET_AUTODIAL_FORCE_ONLINE	Memaksa koneksi online.
INTERNET_AUTODIAL_FORCE_UNATTENDED	Memaksa dial-up Internet tanpa pengawas. Jika intervensi pengguna diperlukan, fungsi akan gagal.
INTERNET_DIAL_FORCE_PROMPT	Mengabaikan pengaturan "putar nomor secara otomatis" dan memaksa antarmuka pengguna putar nomor ditampilkan.
INTERNET_DIAL_UNATTENDED	Terhubung ke Internet melalui modem, tanpa menampilkan antarmuka pengguna, jika memungkinkan. Jika tidak, fungsi akan menunggu input pengguna.
INTERNET_DIAL_SHOW_OFFLINE	Memperlihatkan tombol Bekerja Offline alih-alih tombol Batal di antarmuka pengguna putar nomor.

[out] lpdwConnection

Penunjuk ke variabel yang menentukan nomor koneksi. Nomor ini adalah pengidentifikasi unik untuk koneksi yang dapat digunakan dalam fungsi lain, seperti InternetHangUp.

[in] dwReserved

Parameter ini dicadangkan dan harus NULL.

Nilai kembali

Mengembalikan ERROR_SUCCESS jika berhasil, atau nilai kesalahan sebaliknya. Kode kesalahan bisa menjadi salah satu nilai berikut.

Menampilkan kode	Deskripsi
ERROR_INVALID_PARAMETER	Satu atau beberapa parameter salah.
ERROR_NO_CONNECTION	Ada masalah dengan sambungan putar-nomor.
ERROR_USER_DISCONNECTION	Pengguna mengklik tombol Bekerja Offline atau Batal pada kotak dialog koneksi Internet.

Keterangan

InternetDial tidak mendukung koneksi putar nomor ganda, autentikasi SmartCard, atau koneksi yang memerlukan sertifikasi berbasis registri.

Catatan Dimulai pada Windows Vista dan Windows Server 2008, fungsi dial-up WinINet menggunakan fungsi RAS untuk membuat koneksi dial-up. WinINet mendukung fungsionalitas yang di dokumentasikan dalam fungsi RasDialDlg .

Seperti semua aspek lain dari Api WinINet, fungsi ini tidak dapat dipanggil dengan aman dari dalam DllMain atau konstruktor dan destruktor objek global.

Catatan WinINet tidak mendukung implementasi server. Selain itu, itu tidak boleh digunakan dari layanan. Untuk implementasi atau layanan server, gunakan Microsoft Windows HTTP Services (WinHTTP).

Catatan

Header wininet.h mendefinisikan InternetDial sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor 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	wininet.h (termasuk Wininet.h, Winineti.h, Wininet.h, Winineti.h)
Pustaka	Wininet.lib
DLL	Wininet.dll

Lihat juga

Membuat Sambungan Dial-Up ke Internet

Fungsi WinINet

Bagikan melalui