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 |
---|---|
|
Tidak ada entri lagi. Enumerasi berhasil diselesaikan. Ketika ini terjadi, konten buffer pengembalian, lpBuffer, tidak terdefinisi. |
|
Buffer terlalu kecil untuk menahan bahkan satu entri. |
|
hEnum bukan handel yang valid. |
|
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 |