Fungsi NPAddConnection (npapi.h)

Fungsi NPAddConnection menghubungkan perangkat lokal ke sumber daya jaringan.

Syntax

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

Parameter-parameternya

[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 lain.

Nilai Meaning
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 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

Penunjuk 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

Penunjuk 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 menyambungkan 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, kode kesalahan harus dikembalikan, yang bisa menjadi salah satu dari berikut ini.

Mengembalikan kode Description
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 koneksi 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]
Platform Target Windows
Header npapi.h
Library davclnt.lib
  • Last updated on