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 |
---|---|
|
Pemanggil tidak memiliki akses ke sumber daya jaringan. |
|
Perangkat lokal yang ditentukan oleh lpDevice sudah tersambung ke sumber daya jaringan. |
|
Jenis perangkat lokal dan jenis sumber daya jaringan tidak cocok. |
|
Nilai yang ditentukan oleh lpDevice tidak valid. |
|
Profil pengguna dalam format yang salah. |
|
Router atau penyedia sibuk, mungkin menginisialisasi. Pemanggil harus mencoba kembali. |
|
Upaya untuk membuat koneksi dibatalkan oleh pengguna melalui kotak dialog dari salah satu penyedia sumber daya jaringan, atau oleh sumber daya yang disebut. |
|
Sistem tidak dapat membuka profil pengguna untuk memproses koneksi persisten. |
|
Entri untuk perangkat sudah ada di profil pengguna. |
|
Terjadi kesalahan khusus jaringan. Panggil fungsi WNetGetLastError untuk mendapatkan deskripsi kesalahan. |
|
Kata sandi yang ditentukan tidak valid. |
|
Operasi tidak dapat dilakukan karena komponen jaringan tidak dimulai atau karena nama yang ditentukan tidak dapat digunakan. |
|
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 |