Fungsi WNetConnectionDialog1A (winnetwk.h)

Artikel
03/08/2023

Fungsi WNetConnectionDialog1 memunculkan dialog penjelajahan umum untuk menyambungkan ke sumber daya jaringan. Fungsi ini memerlukan CONNECTDLGSTRUCT untuk membuat parameter kotak dialog.

Sintaks

DWORD WNetConnectionDialog1A(
  [in, out] LPCONNECTDLGSTRUCTA lpConnDlgStruct
);

Parameter

[in, out] lpConnDlgStruct

Penunjuk ke struktur CONNECTDLGSTRUCT . Struktur menetapkan parameter dialog penjelajahan.

Nilai kembali

Jika pengguna membatalkan kotak dialog, fungsi akan mengembalikan –1. Jika fungsi berhasil, fungsi akan mengembalikan NO_ERROR. Selain itu, jika panggilan berhasil, anggota dwDevNum dari struktur CONNECTDLGSTRUCT berisi jumlah perangkat yang terhubung.

Biasanya dialog ini mengembalikan kesalahan hanya jika pengguna tidak dapat memasukkan sesi dialog. Ini karena kesalahan yang terjadi setelah sesi dialog dilaporkan kepada pengguna secara langsung. Jika fungsi gagal, nilai yang dikembalikan adalah kode kesalahan sistem, seperti salah satu nilai berikut.

Menampilkan kode	Deskripsi
ERROR_INVALID_PARAMETER	Opsi kotak dialog CONNDLG_RO_PATH dan CONNDLG_USE_MRU diatur. (Opsi kotak dialog ditentukan oleh anggota dwFlags dari struktur CONNECTDLGSTRUCT .) -atau- Opsi kotak dialog CONNDLG_PERSIST dan kotak dialog CONNDLG_NOT_PERSIST diatur. -atau- Opsi kotak dialog CONNDLG_RO_PATH diatur dan anggota lpRemoteName struktur NETRESOURCE tidak menunjuk ke jaringan jarak jauh. (Struktur CONNECTDLGSTRUCT menunjuk ke struktur NETRESOURCE .)
ERROR_BAD_DEV_TYPE	Anggota dwType dari struktur NETRESOURCE tidak diatur ke RESOURCETYPE_DISK.
ERROR_BUSY	Penyedia jaringan sibuk (mungkin menginisialisasi). Pemanggil harus mencoba kembali.
ERROR_NO_NETWORK	Jaringan tidak tersedia.
ERROR_NOT_ENOUGH_MEMORY	Memori tidak cukup untuk menampilkan kotak dialog.
ERROR_EXTENDED_ERROR	Terjadi kesalahan khusus jaringan. Panggil WNetGetLastError untuk mendapatkan deskripsi kesalahan.

Keterangan

Catatan

Header winnetwk.h mendefinisikan WNetConnectionDialog1 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


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