Bagikan melalui


Fungsi NPEnumResource (npapi.h)

Melakukan enumerasi berdasarkan handel yang dikembalikan oleh NPOpenEnum.

Sintaks

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

Parameter

[in] hEnum

Menangani yang diperoleh dari panggilan NPOpenEnum .

[in, out] lpcCount

Arahkan ke jumlah entri yang diminta. Mungkin 0xFFFFFFFF untuk meminta entri sebanyak mungkin. Jika panggilan berhasil, lokasi ini akan menerima jumlah entri yang benar-benar dibaca.

[out] lpBuffer

Arahkan ke buffer untuk menerima hasil enumerasi, yang dikembalikan sebagai array entri NETRESOURCE . Buffer valid hingga panggilan berikutnya menggunakan hEnum.

[in, out] lpBufferSize

Penunjuk ke ukuran, dalam byte, buffer yang diteruskan ke panggilan fungsi pada entri. Jika buffer terlalu kecil bahkan untuk satu entri, ini harus berisi, saat keluar, jumlah byte yang diperlukan untuk membaca satu entri. Nilai ini diatur hanya jika kode pengembalian WN_MORE_DATA.

Nilai kembali

Jika fungsi berhasil, fungsi harus mengembalikan WN_SUCCESS. Pemanggil dapat terus memanggil NPEnumResource untuk melanjutkan enumerasi. Jika tidak, itu harus mengembalikan salah satu kode kesalahan berikut.

Menampilkan kode Deskripsi
WN_NO_MORE_ENTRIES
Tidak ada entri lagi. Enumerasi berhasil diselesaikan. Ketika ini terjadi, konten buffer pengembalian, lpBuffer, tidak terdefinisi.
WN_MORE_DATA
Buffer terlalu kecil untuk menahan bahkan satu entri.
WN_BAD_HANDLE
hEnum bukan handel yang valid.
WN_NO_NETWORK
Jaringan tidak ada. Kondisi ini diperiksa sebelum hEnum diuji validitasnya.

Keterangan

Ketika fungsi ini dipanggil, penyedia harus mengisi buffer dengan jumlah entri yang diminta (atau maksimum yang dapat pas). Struktur NETRESOURCE yang dikembalikan harus terletak berdampingan di kepala buffer, seperti array struktur tersebut. Penunjuk dalam struktur ini harus menunjuk ke lokasi dalam buffer. Oleh karena itu, data yang dirujuk oleh pointer ini harus terletak di akhir buffer, setelah array struktur. Penyedia bertanggung jawab untuk mengemas informasi ini dengan benar.

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