Funzione FilterInstanceFindNext (fltuser.h)

Articolo
08/23/2023

La funzione FilterInstanceFindNext continua una ricerca di istanza del driver minifilter avviata da una chiamata a FilterInstanceFindFirst.

Sintassi

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

Parametri

[in] hFilterInstanceFind

Handle di ricerca dell'istanza minifilter restituito da una chiamata precedente a FilterInstanceFindFirst.

[in] dwInformationClass

Tipo di struttura delle informazioni dell'istanza restituita. Questo parametro deve contenere uno dei valori seguenti.

Valore	Significato
InstanceBasicInformation	Restituisce una struttura INSTANCE_BASIC_INFORMATION per l'istanza.
InstanceFullInformation	Restituisce una struttura INSTANCE_FULL_INFORMATION per l'istanza.
InstancePartialInformation	Restituisce una struttura INSTANCE_PARTIAL_INFORMATION per l'istanza.
InstanceAggregateStandardInformation	Restituire una struttura INSTANCE_AGGREGATE_STANDARD_INFORMATION per l'istanza. La parte LegacyFilter della struttura non viene utilizzata. Questa struttura è 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 nel buffer è 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 lpBuffer punta se la chiamata a FilterInstanceFindNext ha esito positivo. Questo parametro è obbligatorio e non può essere NULL.

Valore restituito

FilterInstanceFindNext 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 InstanceAggregateStandardInformation viene specificato per un sistema operativo prima di Windows Vista, FilterInstanceFindNext restituisce questo valore HRESULT.
HRESULT_FROM_WIN32(ERROR_NO_MORE_ITEMS)	Questo valore HRESULT viene restituito se non sono presenti istanze più univoche del minifilter.

Commenti

Dopo aver stabilito l'handle di ricerca chiamando FilterInstanceFindFirst, chiamare FilterInstanceFindNext per cercare altre istanze del minifilter specificato nella chiamata a FilterInstanceFindFirst.

FilterInstanceFindNext trova un'istanza per chiamata.