Fungsi WNetGetResourceInformationA (winnetwk.h)

Artikel
03/04/2024

Ketika disediakan dengan jalur jarak jauh ke sumber daya jaringan, fungsi WNetGetResourceInformation mengidentifikasi penyedia jaringan yang memiliki sumber daya dan mendapatkan informasi tentang jenis sumber daya. Fungsi ini biasanya digunakan bersama dengan fungsi WNetGetResourceParent untuk mengurai dan menginterpretasikan jalur jaringan yang ditik oleh pengguna.

Sintaks

DWORD WNetGetResourceInformationA(
  [in]      LPNETRESOURCEA lpNetResource,
  [out]     LPVOID         lpBuffer,
  [in, out] LPDWORD        lpcbBuffer,
  [out]     LPSTR          *lplpSystem
);

Parameter

[in] lpNetResource

Penunjuk ke struktur NETRESOURCE yang menentukan sumber daya jaringan yang informasinya diperlukan.

Anggota lpRemoteName dari struktur harus menentukan nama jalur jarak jauh sumber daya, biasanya satu yang ditik oleh pengguna. Anggota lpProvider dan dwType juga harus diisi jika diketahui, karena operasi ini bisa intensif memori, terutama jika Anda tidak menentukan anggota dwType . Jika Anda tidak tahu nilai untuk anggota ini, Anda harus mengaturnya ke NULL. Semua anggota struktur NETRESOURCE lainnya diabaikan.

[out] lpBuffer

Arahkan ke buffer untuk menerima hasilnya. Setelah berhasil dikembalikan, bagian pertama dari buffer adalah struktur NETRESOURCE yang mewakili bagian dari jalur sumber daya input yang diakses melalui fungsi WNet, bukan melalui fungsi sistem khusus untuk jenis sumber daya input. (Sisa buffer berisi string panjang variabel tempat anggota titik struktur NETRESOURCE .)

Misalnya, jika jalur sumber daya jarak jauh input adalah \server\share\dir1\dir2, maka struktur NETRESOURCE output berisi informasi tentang sumber daya \server\share. Bagian \dir1\dir2 dari jalur diakses melalui fungsi manajemen file. Anggota lpRemoteName, lpProvider, dwType, dwDisplayType, dan dwUsageNETRESOURCE dikembalikan, dengan semua anggota lain diatur ke NULL.

Anggota lpRemoteName dikembalikan dalam sintaks yang sama dengan yang dikembalikan dari enumerasi oleh fungsi WNetEnumResource . Ini memungkinkan pemanggil untuk melakukan perbandingan string untuk menentukan apakah sumber daya yang diteruskan ke WNetGetResourceInformation sama dengan sumber daya yang dikembalikan oleh panggilan terpisah ke WNetEnumResource.

[in, out] lpcbBuffer

Penunjuk ke lokasi yang, pada entri, menentukan ukuran buffer lpBuffer , dalam byte. Buffer yang Anda alokasikan harus cukup besar untuk menahan struktur NETRESOURCE , ditambah string yang ditunjukkan anggotanya. Jika buffer terlalu kecil untuk hasilnya, lokasi ini menerima ukuran buffer yang diperlukan, dan fungsi mengembalikan ERROR_MORE_DATA.

[out] lplpSystem

Jika fungsi berhasil dikembalikan, parameter ini menunjuk ke string dalam buffer output yang menentukan bagian dari sumber daya yang diakses melalui fungsi sistem. (Ini hanya berlaku untuk fungsi khusus untuk jenis sumber daya daripada fungsi WNet.)

Misalnya, jika nama sumber daya jarak jauh input adalah \server\share\dir1\dir2, anggota lpRemoteName dari struktur NETRESOURCE output menunjuk ke \server\share. Selain itu, parameter lplpSystem menunjuk ke \dir1\dir2. Kedua string disimpan dalam buffer yang ditujukkan oleh parameter lpBuffer .

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah NO_ERROR.

Jika fungsi gagal, nilai yang dikembalikan adalah kode kesalahan sistem, seperti salah satu nilai berikut.

Menampilkan kode	Deskripsi
ERROR_BAD_NET_NAME	Anggota lpRemoteName input bukan sumber daya jaringan yang ada untuk jaringan apa pun.
ERROR_BAD_DEV_TYPE	Anggota dwType input tidak cocok dengan jenis sumber daya yang ditentukan oleh anggota lpRemoteName .
ERROR_EXTENDED_ERROR	Terjadi kesalahan khusus jaringan. Panggil WNetGetLastError untuk mendapatkan deskripsi kesalahan.
ERROR_MORE_DATA	Buffer yang diacu oleh parameter lpBuffer terlalu kecil.
ERROR_NO_NETWORK	Jaringan tidak tersedia.

Keterangan

Catatan

Header winnetwk.h mendefinisikan WNetGetResourceInformation sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

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	winnetwk.h
Pustaka	Mpr.lib
DLL	Mpr.dll