Fungsi NPOpenEnum (npapi.h)

  • Artikel

Membuka enumerasi sumber daya jaringan atau koneksi yang ada. Fungsi NPOpenEnum harus dipanggil untuk mendapatkan handel yang valid untuk enumerasi.

Sintaks

DWORD NPOpenEnum(
  [in]  DWORD          dwScope,
  [in]  DWORD          dwType,
  [in]  DWORD          dwUsage,
  [in]  LPNETRESOURCEW lpNetResource,
  [out] LPHANDLE       lphEnum
);

Parameter

[in] dwScope

Menentukan cakupan enumerasi. Ini bisa menjadi salah satu dari berikut ini.

Nilai Makna
RESOURCE_CONNECTED
 Semua sumber daya yang saat ini terhubung.
RESOURCE_GLOBALNET
 Semua sumber daya di jaringan.
RESOURCE_CONTEXT
 Sumber daya yang terkait dengan konteks jaringan pengguna saat ini dan default (digunakan untuk tampilan "Lingkungan Jaringan"). Interpretasi ini diserahkan kepada penyedia.

[in] dwType

Menentukan jenis sumber daya yang diminati. Ini adalah bitmask, yang mungkin merupakan kombinasi dari bendera berikut.

Nilai Makna
RESOURCETYPE_DISK
 Semua sumber daya disk.
RESOURCETYPE_PRINT
 Semua sumber daya cetak.
RESOURCEUSAGE_ATTACHED
 Menentukan bahwa fungsi harus gagal jika pemanggil tidak diautentikasi (bahkan jika jaringan mengizinkan enumerasi tanpa autentikasi).
 

Jika dwType adalah 0, atau hanya RESOURCEUSAGE_ATTACHED, semua jenis sumber daya dikembalikan. Jika penyedia tidak memiliki kemampuan untuk membedakan antara sumber daya cetak dan disk pada tingkat yang sama, penyedia dapat mengembalikan semua sumber daya.

[in] dwUsage

Menentukan penggunaan sumber daya yang tertarik. Ini adalah bitmask, yang mungkin merupakan kombinasi dari bendera berikut.

Nilai Makna
RESOURCEUSAGE_CONNECTABLE
 Semua sumber daya yang dapat dihubungkan
RESOURCEUSAGE_CONTAINER
 Semua sumber daya kontainer
 

Bitmask mungkin nol untuk mencocokkan semua bendera. Parameter ini dapat diabaikan jika dwScope tidak diatur ke RESOURCE_GLOBALNET.

[in] lpNetResource

Arahkan ke kontainer untuk melakukan enumerasi. NETRESOURCE dapat diperoleh melalui panggilan NPEnumResource sebelumnya, atau dibangun oleh pemanggil, atau bisa NULL. Jika null atau jika bidang lpRemoteName dari NETRESOURCEadalah NULL, penyedia harus menghitung tingkat atas jaringannya. Perhatikan bahwa ini berarti penyedia tidak dapat menggunakan lpRemoteNamedari NULL untuk mewakili sumber daya jaringan apa pun. Pemanggil biasanya akan memulai dengan memanggil NPOpenEnum dengan parameter ini diatur ke NULL dan kemudian menggunakan hasil yang dikembalikan untuk enumerasi lebih lanjut. Jika program panggilan tahu persis penyedia dan jalur jarak jauh untuk menghitung dari, itu dapat membangun struktur NETRESOURCE sendiri untuk diteruskan, mengisi bidang lpProvider dan lpRemoteName . Perhatikan bahwa jika dwScope RESOURCE_CONNECTED atau RESOURCE_CONTEXT, parameter ini akan menjadi NULL.

[out] lphEnum

Penunjuk ke handel yang dapat digunakan oleh fungsi NPEnumResource . Setelah Anda selesai menggunakan handel, lepaskan handel dengan memanggil fungsi NPCloseEnum .

Mengembalikan nilai

Jika fungsi berhasil, fungsi harus mengembalikan WN_SUCCESS. Jika tidak, itu harus mengembalikan kode kesalahan yang mungkin mencakup salah satu dari yang berikut ini.

Menampilkan kode Deskripsi
WN_NOT_SUPPORTED
 Penyedia tidak mendukung jenis enumerasi yang diminta, atau sumber daya jaringan tertentu tidak dapat ditelusuri.
WN_NOT_CONTAINER
 lpNetResource tidak menunjuk ke kontainer.
WN_BAD_VALUE
 DwScope, dwUsage, atau dwType tidak valid atau kombinasi parameter yang buruk ditentukan.
WN_NO_NETWORK
 Jaringan tidak ada.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header npapi.h