Fungsi InternetDialW (wininet.h)

Artikel
11/20/2024

Memulai sambungan ke Internet menggunakan modem.

Sintaksis

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 stringnull yang dihentikan 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

Pilihan. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Arti
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 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 Batalkan di antarmuka pengguna pemutaran.

[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.

Mengembalikan nilai

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

Mengembalikan 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 Batalkan pada kotak dialog koneksi Internet.

Komentar

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 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.

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

Nota

Header wininet.h mendefinisikan InternetDial sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosedur 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

Syarat	Nilai
klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	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