Fungsi WNetRestoreConnectionW (winnetwk.h)

[WNetRestoreConnectionW tidak tersedia untuk digunakan pada Windows Vista.]

Fungsi WNetRestoreConnectionW memulihkan koneksi ke sumber daya jaringan. Fungsi ini meminta pengguna, jika perlu, untuk nama dan kata sandi.

Sintaks

DWORD WNetRestoreConnectionW(
  [in] HWND    hWnd,
  [in] LPCWSTR lpDevice
);

Parameter

[in] hWnd

Tangani ke jendela induk yang digunakan fungsi untuk menampilkan antarmuka pengguna (UI) yang meminta nama dan kata sandi kepada pengguna saat membuat koneksi jaringan. Jika parameter ini NULL, tidak ada jendela pemilik.

[in] lpDevice

Penunjuk ke string Unicode yang dihentikan null yang menentukan nama lokal drive untuk disambungkan, seperti "Z:". Jika parameter ini NULL, fungsi menyambungkan kembali semua drive persisten yang disimpan dalam registri untuk pengguna saat ini.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan NO_ERROR.

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

Menampilkan kode	Deskripsi
ERROR_ACCESS_DENIED	Pemanggil tidak memiliki akses ke sumber daya jaringan.
ERROR_ALREADY_ASSIGNED	Perangkat lokal yang ditentukan oleh lpDevice sudah tersambung ke sumber daya jaringan.
ERROR_BAD_DEV_TYPE	Jenis perangkat lokal dan jenis sumber daya jaringan tidak cocok.
ERROR_BAD_DEVICE	Nilai yang ditentukan oleh lpDevice tidak valid.
ERROR_BAD_PROFILE	Profil pengguna dalam format yang salah.
ERROR_BUSY	Router atau penyedia sibuk, mungkin menginisialisasi. Pemanggil harus mencoba kembali.
ERROR_CANCELLED	Upaya untuk membuat koneksi dibatalkan oleh pengguna melalui kotak dialog dari salah satu penyedia sumber daya jaringan, atau oleh sumber daya yang disebut.
ERROR_CANNOT_OPEN_PROFILE	Sistem tidak dapat membuka profil pengguna untuk memproses koneksi persisten.
ERROR_DEVICE_ALREADY_REMEMBERED	Entri untuk perangkat sudah ada di profil pengguna.
ERROR_EXTENDED_ERROR	Terjadi kesalahan khusus jaringan. Panggil fungsi WNetGetLastError untuk mendapatkan deskripsi kesalahan.
ERROR_INVALID_PASSWORD	Kata sandi yang ditentukan tidak valid.
ERROR_NO_NET_OR_BAD_PATH	Operasi tidak dapat dilakukan karena komponen jaringan tidak dimulai atau karena nama yang ditentukan tidak dapat digunakan.
ERROR_NO_NETWORK	Jaringan tidak tersedia.

Keterangan

Fungsi WNetRestoreConnectionW tidak didukung pada Windows Vista dan yang lebih baru.

Untuk memanggil fungsi ini, pertama-tama panggil fungsi LoadLibrary untuk memuat Mpr.dll. Kemudian panggil fungsi GetProcAddress untuk mengambil alamat fungsi WNetRestoreConnectionW .

WNetRestoreConnectionW digunakan oleh Winlogon untuk memulihkan semua pemetaan drive persisten selama proses masuk interaktif. Fungsi ini juga dipanggil oleh Microsoft Windows Shell untuk menyambungkan kembali drive individual sesuai permintaan pengguna. Ini dapat terjadi, misalnya, ketika drive gagal terhubung kembali saat masuk dan pengguna mengklik dua kali drive di bawah folder virtual Komputer Saya.

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	winnetwk.h
Pustaka	Mpr.lib
DLL	Mpr.dll

Lihat juga

Gambaran Umum Windows Networking (WNet)

Fungsi Jaringan Windows