Fungsi WNetAddConnectionA (winnetwk.h)

Artikel
08/27/2023

Fungsi WNetAddConnection memungkinkan aplikasi panggilan untuk menyambungkan perangkat lokal ke sumber daya jaringan. Koneksi yang berhasil persisten, yang berarti bahwa sistem secara otomatis memulihkan koneksi selama operasi masuk berikutnya.

Catatan Fungsi ini disediakan hanya untuk kompatibilitas dengan Windows versi 16-bit. Aplikasi berbasis Windows lainnya harus memanggil WNetAddConnection2 atau fungsi WNetAddConnection3 .

Sintaks

DWORD WNetAddConnectionA(
  [in] LPCSTR lpRemoteName,
  [in] LPCSTR lpPassword,
  [in] LPCSTR lpLocalName
);

Parameter

[in] lpRemoteName

Penunjuk ke string konstanta yang dihentikan null yang menentukan sumber daya jaringan untuk disambungkan.

[in] lpPassword

Penunjuk ke string konstanta yang dihentikan null yang menentukan kata sandi yang akan digunakan untuk membuat koneksi. Parameter ini biasanya merupakan kata sandi yang terkait dengan pengguna saat ini.

Jika parameter ini NULL, kata sandi default akan digunakan. Jika string kosong, tidak ada kata sandi yang digunakan.

Windows Me/98/95: Parameter ini harus NULL atau string kosong.

[in] lpLocalName

Penunjuk ke string konstanta yang dihentikan null yang menentukan nama perangkat lokal yang akan dialihkan, seperti "F:" atau "LPT1". String diperlakukan dengan cara yang tidak peka huruf besar/kecil. Jika string NULL, koneksi ke sumber daya jaringan dibuat tanpa mengalihkan perangkat lokal.

Nilai kembali

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 yang ditentukan dalam parameter lpLocalName sudah tersambung.
ERROR_BAD_DEV_TYPE	Jenis perangkat dan jenis sumber daya tidak cocok.
ERROR_BAD_DEVICE	Nilai yang ditentukan dalam parameter lpLocalName tidak valid.
ERROR_BAD_NET_NAME	Nilai yang ditentukan dalam parameter lpRemoteName tidak valid atau tidak dapat ditemukan.
ERROR_BAD_PROFILE	Profil pengguna dalam format yang salah.
ERROR_CANNOT_OPEN_PROFILE	Sistem tidak dapat membuka profil pengguna untuk memproses koneksi persisten.
ERROR_DEVICE_ALREADY_REMEMBERED	Entri untuk perangkat yang ditentukan dalam parameter lpLocalName sudah ada di profil pengguna.
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_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

Pada Windows Server 2003 dan Windows XP, fungsi WNet membuat dan menghapus huruf drive jaringan di namespace perangkat MS-DOS yang terkait dengan sesi masuk karena perangkat MS-DOS diidentifikasi oleh AuthenticationID (a
pengidentifikasi unik lokal, atau LUID, yang terkait dengan sesi masuk.) Ini dapat memengaruhi aplikasi yang memanggil salah satu fungsi WNet untuk membuat huruf kandar jaringan di bawah satu masuk pengguna, tetapi kueri untuk huruf drive jaringan yang ada di bawah masuk pengguna yang berbeda. Contoh situasi ini bisa jadi ketika log masuk kedua pengguna dibuat dalam sesi masuk, misalnya, dengan memanggil fungsi CreateProcessAsUser , dan masuk kedua menjalankan aplikasi yang memanggil fungsi GetLogicalDrives . Panggilan ke fungsi GetLogicalDrives tidak mengembalikan huruf kandar jaringan yang dibuat oleh panggilan fungsi WNet di bawah masuk pertama. Perhatikan bahwa dalam contoh sebelumnya sesi masuk pertama masih ada, dan contohnya dapat berlaku untuk sesi masuk apa pun, termasuk sesi Layanan Terminal. Untuk informasi selengkapnya, lihat Menentukan Nama Perangkat MS-DOS.

Pada Windows Server 2003 dan Windows XP, jika layanan yang berjalan sebagai LocalSystem memanggil fungsi WNetAddConnection , maka drive yang dipetakan terlihat oleh semua sesi masuk pengguna.

Catatan

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