Fungsi WNetConnectionDialog (winnetwk.h)

Fungsi WNetConnectionDialog memulai kotak dialog penjelajahan umum untuk menyambungkan ke sumber daya jaringan. Fungsi ini memerlukan handel ke jendela pemilik untuk kotak dialog.

Sintaks

DWORD WNetConnectionDialog(
  [in] HWND  hwnd,
  [in] DWORD dwType
);

Parameter

[in] hwnd

Tangani ke jendela pemilik untuk kotak dialog.

[in] dwType

Jenis sumber daya untuk memperbolehkan koneksi. Parameter ini bisa menjadi nilai berikut.

Nilai	Makna
RESOURCETYPE_DISK	Koneksi ke sumber daya disk.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan NO_ERROR. Jika pengguna membatalkan kotak dialog, fungsi akan mengembalikan –1.

Jika fungsi gagal, nilai yang dikembalikan adalah kode kesalahan sistem, seperti salah satu nilai berikut.

Menampilkan kode	Deskripsi
ERROR_EXTENDED_ERROR	Terjadi kesalahan khusus jaringan. Untuk mendapatkan deskripsi kesalahan, panggil fungsi WNetGetLastError .
ERROR_INVALID_PASSWORD	Kata sandi yang ditentukan tidak valid.
ERROR_NO_NETWORK	Jaringan tidak tersedia.
ERROR_NOT_ENOUGH_MEMORY	Memori tidak cukup untuk memulai kotak dialog.

Keterangan

Jika pengguna mengklik OK dalam kotak dialog, koneksi jaringan yang diminta akan dibuat saat fungsi WNetConnectionDialog kembali.

Jika fungsi mencoba membuat koneksi dan penyedia jaringan mengembalikan pesan ERROR_INVALID_PASSWORD, sistem akan meminta pengguna untuk memasukkan kata sandi. Sistem menggunakan kata sandi baru dalam upaya lain untuk membuat koneksi.

Persyaratan

Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	winnetwk.h
Pustaka	Mpr.lib
DLL	Mpr.dll

Lihat juga

WNetAddConnection3

WNetCancelConnection2

WNetDisconnectDialog

Gambaran Umum Windows Networking (WNet)

Fungsi Jaringan Windows