Fungsi NPOpenEnum (npapi.h)

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

Syntax

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

Parameter-parameternya

[in] dwScope

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

Nilai	Meaning
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	Meaning
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	Meaning
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 dapat berupa NULL. Jika null atau jika bidang lpRemoteName dari NETRESOURCENULL, 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, program dapat membangun struktur NETRESOURCE sendiri untuk diteruskan, mengisi bidang lpProvider dan lpRemoteName . Perhatikan bahwa jika dwScope RESOURCE_CONNECTED atau RESOURCE_CONTEXT, parameter ini akan 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, kode kesalahan harus mengembalikan kode kesalahan yang mungkin menyertakan salah satu hal berikut.

Mengembalikan kode	Description
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]
Platform Target	Windows
Header	npapi.h
Library	davclnt.lib