Fungsi WNetEnumResourceA (winnetwk.h)

Artikel
08/27/2023

Fungsi WNetEnumResource melanjutkan enumerasi sumber daya jaringan yang dimulai oleh panggilan ke fungsi WNetOpenEnum .

Sintaks

DWORD WNetEnumResourceA(
  [in]      HANDLE  hEnum,
  [in, out] LPDWORD lpcCount,
  [out]     LPVOID  lpBuffer,
  [in, out] LPDWORD lpBufferSize
);

Parameter

[in] hEnum

Menangani yang mengidentifikasi instans enumerasi. Handel ini harus dikembalikan oleh fungsi WNetOpenEnum .

[in, out] lpcCount

Penunjuk ke variabel yang menentukan jumlah entri yang diminta. Jika angka yang diminta adalah –1, fungsi mengembalikan entri sebanyak mungkin.

Jika fungsi berhasil, pada pengembalian variabel yang ditujukan oleh parameter ini berisi jumlah entri yang benar-benar dibaca.

[out] lpBuffer

Arahkan ke buffer yang menerima hasil enumerasi. Hasilnya dikembalikan sebagai array struktur NETRESOURCE . Perhatikan bahwa buffer yang Anda alokasikan harus cukup besar untuk menahan struktur, ditambah string yang ditunjukkan anggotanya. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

Buffer valid hingga panggilan berikutnya menggunakan handel yang ditentukan oleh parameter hEnum . Urutan struktur NETRESOURCE dalam array tidak dapat diprediksi.

[in, out] lpBufferSize

Penunjuk ke variabel yang menentukan ukuran parameter lpBuffer , dalam byte. Jika buffer terlalu kecil untuk menerima bahkan satu entri, parameter ini menerima ukuran buffer yang diperlukan.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah salah satu nilai berikut.

Menampilkan kode	Deskripsi
NO_ERROR	Enumerasi berhasil, dan buffer berisi data yang diminta. Aplikasi panggilan dapat terus memanggil WNetEnumResource untuk menyelesaikan enumerasi.
ERROR_NO_MORE_ITEMS	Tidak ada entri lagi. Konten buffer tidak terdefinisi.

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

Menampilkan kode	Deskripsi
ERROR_MORE_DATA	Entri lainnya tersedia dengan panggilan berikutnya. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.
ERROR_INVALID_HANDLE	Handel yang ditentukan oleh parameter hEnum tidak valid.
ERROR_NO_NETWORK	Jaringan tidak tersedia. (Kondisi ini diuji sebelum hEnum diuji validitasnya.)
ERROR_EXTENDED_ERROR	Terjadi kesalahan khusus jaringan. Untuk mendapatkan deskripsi kesalahan, panggil fungsi WNetGetLastError .

Keterangan

Fungsi WNetEnumResource tidak menghitung pengguna yang terhubung ke berbagi; Anda dapat memanggil fungsi NetConnectionEnum untuk menyelesaikan tugas ini. Untuk menghitung berbagi tersembunyi, panggil fungsi NetShareEnum .

Aplikasi tidak dapat mengatur parameter lpBuffer ke NULL dan mengambil ukuran buffer yang diperlukan dari parameter lpBufferSize . Sebaliknya, aplikasi harus mengalokasikan buffer dengan ukuran yang wajar—16 kilobyte adalah tipikal—dan menggunakan nilai lpBufferSize untuk deteksi kesalahan.

Contoh

Untuk sampel kode yang mengilustrasikan fungsi yang ditentukan aplikasi yang menghitung semua sumber daya di jaringan, lihat Menghitung Sumber Daya Jaringan.

Catatan

Header winnetwk.h mendefinisikan WNetEnumResource 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


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