Funzione FilterGetInformation (fltuser.h)
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 |
---|---|
|
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. |
|
È 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. |
Commenti
FilterGetInformation è l'equivalente Win32 di FltGetFilterInformation.
Requisiti
Piattaforma di destinazione | Universale |
Intestazione | fltuser.h (include FltUser.h) |
Libreria | FltLib.lib |
DLL | FltLib.dll |
Vedi anche
FILTER_AGGREGATE_BASIC_INFORMATION