Funzione FilterFindNext (fltuser.h)

Articolo
03/13/2024

La funzione FilterFindNext continua una ricerca di filtro avviata da una chiamata a FilterFindFirst.

Sintassi

HRESULT FilterFindNext(
  [in]  HANDLE                   hFilterFind,
  [in]  FILTER_INFORMATION_CLASS dwInformationClass,
  [out] LPVOID                   lpBuffer,
  [in]  DWORD                    dwBufferSize,
  [out] LPDWORD                  lpBytesReturned
);

Parametri

[in] hFilterFind

Gestire ricerca filtro restituito da una chiamata precedente a FilterFindFirst.

[in] dwInformationClass

Tipo di informazioni richieste. Questo parametro deve essere uno dei valori seguenti.

Valore	Significato
FilterFullInformation	Il buffer a cui punta il parametro lpBuffer riceve una struttura FILTER_FULL_INFORMATION per ogni istanza di minifilter. I filtri legacy vengono ignorati.
FilterAggregateBasicInformation	Il buffer a cui punta il parametro lpBuffer riceve una struttura FILTER_AGGREGATE_BASIC_INFORMATION per ogni istanza di minifilter o filtro legacy. Questo valore dwInformationClass è disponibile a partire da Microsoft Windows Server 2003 con SP1 e Windows XP con sp2 con rollup di Gestione filtri. Per altre informazioni sul pacchetto di rollup di Gestione filtri per Windows XP con SP2, vedere l'articolo 914882, " Pacchetto di rollup di Gestione filtri per Windows XP SP2" nella Microsoft Knowledge Base.
FilterAggregateStandardInformation	Il buffer a cui punta il parametro lpBuffer riceve una struttura FILTER_AGGREGATE_STANDARD_INFORMATION per ogni istanza di minifilter o filtro legacy. Questo valore dwInformationClass è disponibile a partire da Windows Vista.

[out] lpBuffer

Puntatore a un buffer allocato dal chiamante che riceve le informazioni richieste. Il tipo delle informazioni restituite è definito dal parametro dwInformationClass .

[in] dwBufferSize

Dimensioni, in byte, del buffer a cui punta il parametro lpBuffer . Il chiamante deve impostare questo parametro in base all'oggetto dwInformationClass specificato.

[out] lpBytesReturned

Puntatore a una variabile allocata dal chiamante che riceve il numero di byte restituiti nel buffer a cui punta lpBuffer se la chiamata a FilterFindNext ha esito positivo. Questo parametro è obbligatorio e non può essere NULL.

Valore restituito

FilterFindNext restituisce S_OK se riuscito. In caso contrario, restituisce un valore di errore HRESULT, ad esempio uno dei seguenti:

Codice restituito	Descrizione
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	Il buffer a cui punta lpBuffer non è sufficiente per contenere le informazioni richieste. Quando viene restituito questo valore, lpBytesReturned conterrà le dimensioni, in byte, del buffer necessario per la struttura dwInformationClass specificata.
HRESULT_FROM_WIN32(ERROR_INVALID_PARAMETER)	È stato specificato un valore non valido per il parametro dwInformationClass . Ad esempio, se FilterAggregateStandardInformation viene specificato per un sistema operativo prima di Windows Vista, FilterFindNext restituisce questo valore HRESULT.
HRESULT_FROM_WIN32(ERROR_NO_MORE_ITEMS)	Non sono stati trovati più driver di filtro nell'elenco globale dei driver di filtro registrati.

Commenti

Dopo aver stabilito l'handle di ricerca del filtro chiamando FilterFindFirst, usare la funzione FilterFindNext per cercare filtri aggiuntivi nell'elenco globale dei filtri registrati.

FilterFindNext trova un driver di filtro (istanza del driver minifilter o driver di filtro legacy) per chiamata.

A partire da Microsoft Windows Server 2003 con SP1 e Microsoft Windows XP con SP2 con rollup di filter manager, FilterFindFirst e FilterFindNext possono fornire informazioni sul driver di filtro legacy e informazioni sull'istanza del driver minifilter. Nelle versioni precedenti di Windows , FilterFindFirst e FilterFindNext possono fornire solo informazioni sui minifilter (vedere la descrizione del parametro dwInformationClass precedente).

FilterFindFirst e FilterFindNext restituiscono informazioni sui driver di filtro in ordine di riduzione della distanza dal file system di base. Le informazioni sul filtro più lontano dal file system di base vengono restituite prima. Le informazioni sul secondo filtro più lontano vengono restituite secondo. Le informazioni sul filtro più vicino al file system di base vengono restituite l'ultima.