Fungsi NetUseGetInfo (lmuse.h)

Artikel
08/24/2023

Fungsi NetUseGetInfo mengambil informasi tentang koneksi ke sumber daya bersama.

Anda juga dapat menggunakan fungsi WNetGetConnection untuk mengambil nama sumber daya jaringan yang terkait dengan perangkat lokal.

Sintaks

NET_API_STATUS NET_API_FUNCTION NetUseGetInfo(
  [in]  LMSTR  UncServerName,
  [in]  LMSTR  UseName,
  [in]  DWORD  LevelFlags,
  [out] LPBYTE *bufptr
);

Parameter

[in] UncServerName

Nama UNC komputer untuk menjalankan fungsi ini. Jika ini adalah parameter 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] UseName

Penunjuk ke string yang menentukan nama koneksi yang akan mengembalikan informasi.

String ini adalah Unicode jika _WIN32_WINNT atau FORCE_UNICODE ditentukan.

[in] LevelFlags

Tingkat informasi data yang diminta. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
0	Menentukan nama perangkat lokal dan nama berbagi sumber daya jarak jauh. Parameter BufPtr adalah penunjuk ke struktur USE_INFO_0 .
1	Menentukan informasi tentang koneksi antara perangkat lokal dan sumber daya bersama, termasuk status dan jenis koneksi. Parameter BufPtr adalah penunjuk ke struktur USE_INFO_1 .
2	Menentukan informasi tentang koneksi antara perangkat lokal dan sumber daya bersama. Informasi mencakup status koneksi, jenis koneksi, nama pengguna, dan nama domain. Parameter BufPtr adalah penunjuk ke struktur USE_INFO_2 .

[out] bufptr

Penunjuk ke buffer yang menerima data. Format data ini tergantung pada nilai parameter Tingkat . Buffer ini dialokasikan oleh sistem dan harus dikosongkan menggunakan fungsi NetApiBufferFree . Untuk informasi selengkapnya, lihat Buffer Fungsi Manajemen Jaringan dan Panjang Buffer Fungsi Manajemen Jaringan.

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

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

Untuk mencantumkan semua koneksi saat ini antara komputer lokal dan sumber daya di server jarak jauh, Anda dapat memanggil fungsi NetUseEnum .

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

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