Funzione FilterGetInformation (fltuser.h)

Articolo
08/23/2023

La funzione FilterGetInformation restituisce vari tipi di informazioni su un minifilter.

Sintassi

HRESULT FilterGetInformation(
  [in]  HFILTER                  hFilter,
  [in]  FILTER_INFORMATION_CLASS dwInformationClass,
  [out] LPVOID                   lpBuffer,
  [in]  DWORD                    dwBufferSize,
  [out] LPDWORD                  lpBytesReturned
);

Parametri

[in] hFilter

Handle restituito da una chiamata precedente alla funzione FilterCreate .

[in] dwInformationClass

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

Valore	Significato
FilterFullInformation	Restituisce una struttura FILTER_FULL_INFORMATION per il minifilter.
FilterAggregateBasicInformation	Restituisce una struttura FILTER_AGGREGATE_BASIC_INFORMATION per il minifilter. Questo valore dwInformationClass è disponibile a partire da Microsoft Windows Server 2003 con SP1 e Microsoft Windows XP con SP2 con rollup del gestore 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	Restituisce una struttura FILTER_AGGREGATE_STANDARD_INFORMATION per ogni minifilter. La parte LegacyFilter della struttura non viene utilizzata. 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 di 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 FilterGetInformation ha esito positivo. Questo parametro è obbligatorio e non può essere NULL.

Valore restituito

FilterGetInformation restituisce S_OK in caso di esito positivo. 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, FilterGetInformation restituisce questo valore HRESULT.