Fungsi NPAddConnection (npapi.h)

  • Artikel

Fungsi NPAddConnection menyambungkan perangkat lokal ke sumber daya jaringan.

Sintaks

DWORD NPAddConnection(
  [in] LPNETRESOURCEW lpNetResource,
  [in] LPWSTR         lpPassword,
  [in] LPWSTR         lpUserName
);

Parameter

[in] lpNetResource

Penunjuk ke struktur NETRESOURCE yang menentukan sumber daya jaringan yang akan disambungkan. Bidang berikut harus diatur dalam struktur NETRESOURCE yang Anda lewati. Fungsi NPAddConnection mengabaikan bidang lainnya.

Nilai Makna
lpRemoteName
 Menentukan sumber daya jaringan yang akan disambungkan.
lpLocalName
 Menentukan nama perangkat lokal yang akan dialihkan, seperti "F:" atau "LPT1". Nama ini diperlakukan sebagai tidak peka huruf besar/kecil dan mungkin merupakan string kosong atau penunjuk NULL . Jika string kosong atau NULL, fungsi tersambung ke sumber daya jaringan tanpa melakukan pengalihan.
dwType
 Menentukan jenis sumber daya yang akan disambungkan. Ini bisa RESOURCETYPE_DISK, RESOURCETYPE _PRINT, atau RESOURCETYPE_ANY. Nilai RESOURCETYPE _ANY digunakan jika pemanggil tidak peduli atau tidak tahu.

[in] lpPassword

Arahkan ke kata sandi yang akan digunakan dalam membuat koneksi, biasanya kata sandi yang terkait dengan lpUserName. Nilai NULL dapat diteruskan untuk menyebabkan fungsi menggunakan kata sandi default. String kosong dapat digunakan untuk menunjukkan tidak ada kata sandi. Setelah Anda selesai menggunakan kata sandi, bersihkan dari memori dengan memanggil fungsi SecureZeroMemory . Untuk informasi selengkapnya tentang melindungi kata sandi, lihat Menangani Kata Sandi.

[in] lpUserName

Arahkan ke nama pengguna yang digunakan untuk membuat koneksi. Jika NULL, nama pengguna default (nama pengguna yang saat ini masuk) diterapkan. Ini digunakan ketika pengguna ingin terhubung ke sumber daya tetapi memiliki nama pengguna atau akun yang ditetapkan berbeda untuk sumber daya tersebut.

Misalnya, jika Anda dicatat menggunakan nama pengguna "MyAccount" dan ingin terhubung ke sumber daya jaringan yang hanya tersedia untuk akun kedua, di mana nama pengguna adalah "MyOtherAccount", Anda dapat menentukan "MyOtherAccount" di lpUserName untuk terhubung ke sumber daya. Anda juga akan menentukan kata sandi akun kedua ini di lpPassword.

Mengembalikan nilai

Jika fungsi berhasil, fungsi harus mengembalikan WN_SUCCESS. Jika tidak, itu harus mengembalikan kode kesalahan, yang bisa menjadi salah satu dari yang berikut ini.

Menampilkan kode Deskripsi
WN_BAD_NETNAME
 Nilai anggota lpRemoteName dari struktur yang diteruskan ke lpNetResource tidak valid untuk penyedia ini.
WN_BAD_LOCALNAME
 Nilai anggota lpLocalName dari struktur yang diteruskan ke lpNetResource tidak valid.
WN_BAD_PASSWORD
 Kata sandi yang ditentukan tidak valid.
WN_ALREADY_CONNECTED
 Perangkat yang ditentukan dalam anggota lpLocalName struktur yang diteruskan ke lpNetResource sudah tersambung.
WN_ACCESS_DENIED
 Izin untuk membuat sambungan ditolak.
WN_NO_NETWORK
 Jaringan tidak ada.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header npapi.h