Fungsi WNetOpenEnumA (winnetwk.h)

Artikel
03/08/2023

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.

Nilai	Makna
RESOURCE_CONNECTED	Hitung semua sumber daya yang saat ini tersambung. Fungsi mengabaikan parameter dwUsage . Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.
RESOURCE_CONTEXT	Hitung hanya sumber daya dalam konteks jaringan pemanggil. Tentukan nilai ini untuk tampilan Lingkungan Jaringan. Fungsi mengabaikan parameter dwUsage .
RESOURCE_GLOBALNET	Menghitung semua sumber daya di jaringan.
RESOURCE_REMEMBERED	Menghitung semua koneksi yang diingat (persisten). Fungsi mengabaikan parameter dwUsage .

[in] dwType

Jenis sumber daya yang akan dijumlahkan. Parameter ini bisa menjadi kombinasi dari nilai berikut.

Nilai	Makna
RESOURCETYPE_ANY	Semua sumber daya Nilai ini tidak dapat digabungkan dengan RESOURCETYPE_DISK atau RESOURCETYPE_PRINT.
RESOURCETYPE_DISK	Semua sumber daya disk.
RESOURCETYPE_PRINT	Semua sumber daya cetak.

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.

Nilai	Makna
0	Semua sumber daya
RESOURCEUSAGE_CONNECTABLE	Semua sumber daya yang dapat dihubungkan.
RESOURCEUSAGE_CONTAINER	Semua sumber daya kontainer.
RESOURCEUSAGE_ATTACHED	Mengatur nilai ini memaksa WNetOpenEnum gagal jika pengguna tidak diautentikasi. Fungsi gagal bahkan jika jaringan memungkinkan enumerasi tanpa autentikasi.
RESOURCEUSAGE_ALL	Mengatur nilai ini setara dengan pengaturan RESOURCEUSAGE_CONNECTABLE, RESOURCEUSAGE_CONTAINER, dan RESOURCEUSAGE_ATTACHED.

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
ERROR_NOT_CONTAINER	Parameter lpNetResource tidak menunjuk ke kontainer.
ERROR_INVALID_PARAMETER	Baik parameter dwScope atau dwType tidak valid, atau ada kombinasi parameter yang tidak valid.
ERROR_NO_NETWORK	Jaringan tidak tersedia.
ERROR_EXTENDED_ERROR	Terjadi kesalahan khusus jaringan. Untuk mendapatkan deskripsi kesalahan, panggil fungsi WNetGetLastError .
ERROR_INVALID_ADDRESS	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