Bagikan melalui


Fungsi FilterInstanceFindNext (fltuser.h)

Fungsi FilterInstanceFindNext melanjutkan pencarian instans driver minifilter yang dimulai dengan panggilan ke FilterInstanceFindFirst.

Sintaks

HRESULT FilterInstanceFindNext(
  [in]  HANDLE                     hFilterInstanceFind,
  [in]  INSTANCE_INFORMATION_CLASS dwInformationClass,
  [out] LPVOID                     lpBuffer,
  [in]  DWORD                      dwBufferSize,
  [out] LPDWORD                    lpBytesReturned
);

Parameter

[in] hFilterInstanceFind

Handel pencarian instans minifilter yang dikembalikan oleh panggilan sebelumnya ke FilterInstanceFindFirst.

[in] dwInformationClass

Jenis struktur informasi instans dikembalikan. Parameter ini harus berisi salah satu nilai berikut.

Nilai Makna
InstanceBasicInformation Mengembalikan struktur INSTANCE_BASIC_INFORMATION untuk instans.
InstanceFullInformation Mengembalikan struktur INSTANCE_FULL_INFORMATION untuk instans.
InstancePartialInformation Mengembalikan struktur INSTANCE_PARTIAL_INFORMATION untuk instans.
InstanceAggregateStandardInformation Mengembalikan struktur INSTANCE_AGGREGATE_STANDARD_INFORMATION untuk instans. Bagian LegacyFilter dari struktur tidak digunakan. Struktur ini tersedia dimulai dengan Windows Vista.

[out] lpBuffer

Arahkan ke buffer yang dialokasikan penelepon yang menerima informasi yang diminta. Jenis informasi yang dikembalikan dalam buffer ditentukan oleh parameter dwInformationClass .

[in] dwBufferSize

Ukuran, dalam byte, dari buffer yang dirujuk parameter lpBuffer . Pemanggil harus mengatur parameter ini sesuai dengan dwInformationClass yang diberikan.

[out] lpBytesReturned

Penunjuk ke variabel yang dialokasikan pemanggil yang menerima jumlah byte yang dikembalikan dalam buffer yang ditunjuk lpBuffer jika panggilan ke FilterInstanceFindNext berhasil. Parameter ini diperlukan dan tidak boleh NULL.

Nilai kembali

FilterInstanceFindNext mengembalikan S_OK jika berhasil. Jika tidak, ia mengembalikan nilai kesalahan HRESULT, seperti salah satu hal berikut ini:

Menampilkan kode Deskripsi
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)
Buffer yang ditujukkan oleh lpBuffer tidak cukup besar untuk berisi informasi yang diminta. Ketika nilai ini dikembalikan, lpBytesReturned akan berisi ukuran, dalam byte, dari buffer yang diperlukan untuk struktur dwInformationClass yang diberikan.
HRESULT_FROM_WIN32(ERROR_INVALID_PARAMETER)
Nilai yang tidak valid ditentukan untuk parameter dwInformationClass . Misalnya, jika InstanceAggregateStandardInformation ditentukan untuk sistem operasi sebelum Windows Vista, FilterInstanceFindNext mengembalikan nilai HRESULT ini.
HRESULT_FROM_WIN32(ERROR_NO_MORE_ITEMS)
Nilai HRESULT ini dikembalikan jika tidak ada lagi instans unik dari minifilter.

Keterangan

Setelah handel pencarian dibuat dengan memanggil FilterInstanceFindFirst, panggil FilterInstanceFindNext untuk mencari instans lain untuk minifilter yang ditentukan dalam panggilan ke FilterInstanceFindFirst.

FilterInstanceFindNext menemukan satu instans per panggilan.

Persyaratan

   
Target Platform Universal
Header fltuser.h (termasuk FltUser.h)
Pustaka FltLib.lib
DLL FltLib.dll

Lihat juga

FilterInstanceFindClose

FilterInstanceFindFirst

INSTANCE_AGGREGATE_STANDARD_INFORMATION

INSTANCE_BASIC_INFORMATION

INSTANCE_FULL_INFORMATION

INSTANCE_PARTIAL_INFORMATION