Fungsi NetUseAdd (lmuse.h)

Artikel
03/14/2023

Fungsi NetUseAdd membuat koneksi antara komputer lokal dan server jarak jauh. Anda dapat menentukan huruf kandar lokal atau perangkat printer yang akan disambungkan. Jika Anda tidak menentukan huruf kandar lokal atau perangkat printer, fungsi akan mengautentikasi klien dengan server untuk koneksi di masa mendatang.

Sintaks

NET_API_STATUS NET_API_FUNCTION NetUseAdd(
  [in]  LPTSTR  servername,
  [in]  DWORD   LevelFlags,
  [in]  LPBYTE  buf,
  [out] LPDWORD parm_err
);

Parameter

[in] servername

Nama UNC komputer untuk menjalankan fungsi ini. Jika parameter ini NULL, maka komputer lokal digunakan. Jika parameter UncServerName yang ditentukan adalah komputer jarak jauh, komputer jarak jauh harus mendukung panggilan RPC jarak jauh menggunakan mekanisme Protokol Akses Jarak Jauh warisan.

String ini adalah Unicode jika _WIN32_WINNT atau FORCE_UNICODE ditentukan.

[in] LevelFlags

Nilai yang menentukan tingkat informasi data. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
1	Menentukan informasi tentang koneksi antara perangkat lokal dan sumber daya bersama. Informasi mencakup status dan jenis koneksi. Parameter Buf adalah penunjuk ke struktur USE_INFO_1 .
2	Menentukan informasi tentang koneksi antara perangkat lokal dan sumber daya bersama. Informasi mencakup status dan jenis koneksi, serta nama pengguna dan nama domain. Parameter Buf adalah penunjuk ke struktur USE_INFO_2 .

[in] buf

Penunjuk ke buffer yang menentukan data. Format data ini tergantung pada nilai parameter Tingkat . Untuk informasi selengkapnya, lihat Buffer Fungsi Manajemen Jaringan.

[out] parm_err

Penunjuk ke nilai yang menerima indeks anggota pertama struktur informasi dalam kesalahan saat kesalahan ERROR_INVALID_PARAMETER dikembalikan. Jika parameter ini NULL, indeks tidak dikembalikan pada kesalahan. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan NERR_Success.

Jika fungsi gagal, nilai yang dikembalikan adalah kode kesalahan sistem. Untuk daftar kode kesalahan, lihat Kode Kesalahan Sistem.

Keterangan

Anda juga dapat menggunakan fungsi WNetAddConnection2 dan WNetAddConnection3 untuk mengalihkan perangkat lokal ke sumber daya jaringan.

Tidak diperlukan keanggotaan grup khusus untuk memanggil fungsi NetUseAdd . Fungsi ini tidak dapat dijalankan pada server jarak jauh kecuali dalam kasus kompatibilitas tingkat bawah.

Fungsi ini hanya berlaku untuk klien Blok Pesan Server (Stasiun Kerja Manajer LAN). Fungsi NetUseAdd tidak mendukung berbagi Sistem File Terdistribusi (DFS). Untuk menambahkan berbagi menggunakan penyedia jaringan yang berbeda (WebDAV atau berbagi DFS, misalnya), gunakan fungsi WNetAddConnection2 atau WNetAddConnection3 .

Jika fungsi NetUseAdd mengembalikan ERROR_INVALID_PARAMETER, Anda dapat menggunakan parameter ParmError untuk menunjukkan anggota pertama struktur informasi yang tidak valid. (Struktur informasi dimulai dengan USE_INFO_ dan formatnya ditentukan oleh parameter Tingkat .) Tabel berikut mencantumkan nilai yang dapat dikembalikan dalam parameter ParmError dan anggota struktur terkait yang mengalami kesalahan. (Awalan ui*_ menunjukkan bahwa anggota dapat dimulai dengan beberapa awalan, misalnya, ui1_ atau ui2_.)

Terus-menerus	Nilai	Anggota
USE_LOCAL_PARMNUM	1	ui*_local
USE_REMOTE_PARMNUM	2	ui*_remote
USE_PASSWORD_PARMNUM	3	ui*_password
USE_ASGTYPE_PARMNUM	4	ui*_asg_type
USE_USERNAME_PARMNUM	5	ui*_username
USE_DOMAINNAME_PARMNUM	6	ui*_domainname

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	lmuse.h (termasuk Lm.h)
Pustaka	Netapi32.lib
DLL	Netapi32.dll