Fungsi WNetOpenEnumA (winnetwk.h)
Fungsi WNetOpenEnum memulai enumerasi sumber daya jaringan atau koneksi yang ada. Anda dapat melanjutkan enumerasi dengan memanggil fungsi WNetEnumResource .
Sintaks
DWORD WNetOpenEnumA(
[in] DWORD dwScope,
[in] DWORD dwType,
[in] DWORD dwUsage,
[in] LPNETRESOURCEA lpNetResource,
[out] LPHANDLE lphEnum
);
Parameter
[in] dwScope
Cakupan enumerasi. Parameter ini bisa menjadi salah satu nilai berikut.
[in] dwType
Jenis sumber daya yang akan dijumlahkan. Parameter ini bisa menjadi kombinasi dari nilai berikut.
Jika penyedia jaringan tidak dapat membedakan antara sumber daya cetak dan disk, penyedia jaringan dapat menghitung semua sumber daya.
[in] dwUsage
Jenis penggunaan sumber daya yang akan dijumlahkan. Parameter ini bisa menjadi kombinasi dari nilai berikut.
Parameter ini diabaikan kecuali parameter dwScope sama dengan RESOURCE_GLOBALNET. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.
[in] lpNetResource
Arahkan ke struktur NETRESOURCE yang menentukan kontainer untuk dijumlahkan. Jika parameter dwScope tidak RESOURCE_GLOBALNET, parameter ini harus NULL.
Jika parameter ini NULL, akar jaringan diasumsikan. (Sistem mengatur jaringan sebagai hierarki; akarnya adalah kontainer paling atas dalam jaringan.)
Jika parameter ini bukan NULL, parameter harus menunjuk ke struktur NETRESOURCE . Struktur ini dapat diisi oleh aplikasi atau dapat dikembalikan dengan panggilan ke fungsi WNetEnumResource . Struktur NETRESOURCE harus menentukan sumber daya kontainer; artinya, nilai RESOURCEUSAGE_CONTAINER harus ditentukan dalam parameter dwUsage .
Untuk menghitung semua sumber daya jaringan, aplikasi dapat memulai enumerasi dengan memanggil WNetOpenEnum dengan parameter lpNetResource diatur ke NULL, lalu menggunakan handel yang dikembalikan untuk memanggil WNetEnumResource untuk menghitung sumber daya. Jika salah satu sumber daya dalam array NETRESOURCE yang dikembalikan oleh fungsi WNetEnumResource adalah sumber daya kontainer, Anda dapat memanggil WNetOpenEnum untuk membuka sumber daya untuk enumerasi lebih lanjut.
[out] lphEnum
Arahkan ke handel enumerasi yang dapat digunakan dalam panggilan berikutnya ke WNetEnumResource.
Nilai kembali
Jika fungsi berhasil, nilai yang dikembalikan NO_ERROR.
Jika fungsi gagal, nilai yang dikembalikan adalah kode kesalahan sistem, seperti salah satu nilai berikut.
Menampilkan kode | Deskripsi |
---|---|
|
Parameter lpNetResource tidak menunjuk ke kontainer. |
|
Baik parameter dwScope atau dwType tidak valid, atau ada kombinasi parameter yang tidak valid. |
|
Jaringan tidak tersedia. |
|
Terjadi kesalahan khusus jaringan. Untuk mendapatkan deskripsi kesalahan, panggil fungsi WNetGetLastError . |
|
Nama sumber daya jaringan jarak jauh yang disediakan dalam struktur NETRESOURCE diselesaikan ke alamat jaringan yang tidak valid. |
Keterangan
Jika parameter dwScope sama dengan RESOURCE_CONNECTED, koneksi jaringan yang dibuat menggunakan jaringan Microsoft LAN Manager dihilangkan dari enumerasi jika koneksi dibuat oleh aplikasi yang berjalan dalam sesi masuk yang berbeda dari aplikasi yang memanggil fungsi WNetOpenEnum . Ini karena koneksi yang dibuat menggunakan Microsoft LAN Manager hanya terlihat oleh aplikasi yang berjalan dalam sesi masuk yang sama dengan aplikasi yang membuat koneksi. (Untuk menyertakan koneksi dalam enumerasi, tidak cukup bagi aplikasi untuk berjalan di akun pengguna yang membuat koneksi.)
Interpretasi yang tepat dari RESOURCE_CONTEXT dalam parameter dwScope tergantung pada jaringan yang diinstal pada komputer.
Fungsi WNetOpenEnum digunakan untuk memulai enumerasi sumber daya dalam satu kontainer. Contoh berikut menunjukkan struktur hierarkis jaringan Microsoft LAN Manager dan jaringan Novell NetWare dan mengidentifikasi kontainer.
LanMan (container, in this case the provider)
ACCOUNTING (container, in this case the domain)
\\ACCTSPAY (container, in this case the server)
PAYFILES (disk)
LASERJET (print)
NetWare (container, in this case the provider)
MARKETING (container, in this case the server)
SYS (disk, first one on any NetWare server)
ANOTHERVOLUME (disk)
LASERJET (print)
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 WNetOpenEnum 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 |
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