Fungsi WNetEnumResourceA (winnetwk.h)

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

Sintaksis

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

Parameter

[in] hEnum

Tangani 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 ditujukkan oleh parameter ini berisi jumlah entri yang benar-benar dibaca.

[out] lpBuffer

Penunjuk 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 ditunjuk anggotanya. Untuk informasi selengkapnya, lihat bagian Komentar 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.

Mengembalikan nilai

Jika fungsi berhasil, nilai pengembalian adalah salah satu nilai berikut.

Mengembalikan 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.

Mengembalikan kode	Deskripsi
ERROR_MORE_DATA	Entri lainnya tersedia dengan panggilan berikutnya. Untuk informasi selengkapnya, lihat bagian Komentar 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.

Komentar

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 khas—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.

Nota

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

Syarat	Nilai
klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	winnetwk.h
Pustaka	Mpr.lib
DLL	Mpr.dll

Lihat juga

NETRESOURCE

WNetCloseEnum

WNetOpenEnum

Gambaran Umum Windows Networking (WNet)

Fungsi Jaringan Windows