Fungsi NetFileGetInfo (lmshare.h)
Mengambil informasi tentang pembukaan sumber daya server tertentu.
Sintaks
NET_API_STATUS NET_API_FUNCTION NetFileGetInfo(
[in] LMSTR servername,
[in] DWORD fileid,
[in] DWORD level,
[out] LPBYTE *bufptr
);
Parameter
[in] servername
Penunjuk ke string yang menentukan nama DNS atau NetBIOS dari server jarak jauh tempat fungsi dijalankan. Jika parameter ini NULL, komputer lokal akan digunakan.
String ini adalah Unicode jika _WIN32_WINNT atau FORCE_UNICODE ditentukan.
[in] fileid
Menentukan pengidentifikasi file dari sumber daya terbuka untuk mengembalikan informasi. Nilai parameter ini harus dikembalikan dalam panggilan enumerasi sebelumnya. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.
[in] level
Menentukan tingkat informasi data. Parameter ini bisa menjadi salah satu nilai berikut.
Nilai | Makna |
---|---|
|
Mengembalikan nomor identifikasi file. Parameter bufptr adalah penunjuk ke struktur FILE_INFO_2 . |
|
Mengembalikan nomor identifikasi file dan informasi lain tentang file. Parameter bufptr adalah penunjuk ke struktur FILE_INFO_3 . |
[out] bufptr
Arahkan ke alamat buffer yang menerima informasi. 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 adalah NERR_Success.
Jika fungsi gagal, nilai yang dikembalikan bisa menjadi salah satu kode kesalahan berikut.
Menampilkan kode | Deskripsi |
---|---|
|
Pengguna tidak memiliki akses ke informasi yang diminta. |
|
File tidak ditemukan. |
|
Nilai yang ditentukan untuk parameter tingkat tidak valid. |
|
Memori tidak cukup tersedia. |
|
Buffer yang disediakan terlalu kecil. |
Keterangan
Hanya anggota grup lokal Administrator atau Operator Server yang berhasil menjalankan fungsi NetFileGetInfo .
Anda dapat memanggil fungsi NetFileEnum untuk mengambil informasi tentang beberapa file yang terbuka di server.
Jika Anda memprogram Direktori Aktif, Anda mungkin dapat memanggil metode Antarmuka Layanan Direktori Aktif (ADSI) tertentu untuk mencapai fungsionalitas yang sama yang dapat Anda capai dengan memanggil NetFileGetInfo. Untuk informasi selengkapnya, lihat IADsResource dan IADsFileServiceOperations.
Persyaratan
Klien minimum yang didukung | Windows XP [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | lmshare.h (termasuk Lm.h) |
Pustaka | Netapi32.lib |
DLL | Netapi32.dll |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk