Fungsi InternetDialW (winineti.h)

Artikel
08/27/2023

Memulai koneksi ke Internet menggunakan modem.

Sintaks

DWORD InternetDialW(
  [in]  HWND      hwndParent,
  [in]  LPWSTR    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 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 yang tak terjaga. 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	Menampilkan tombol Bekerja Offline alih-alih tombol Batal di antarmuka pengguna putar nomor.

[out] lpdwConnection

Penunjuk ke variabel yang menentukan nomor koneksi. Angka 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 sambungan 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 didokumenkan 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 winineti.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	winineti.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