Funzione FilterInstanceGetInformation (fltuser.h)

Articolo
08/23/2023

La funzione FilterInstanceGetInformation restituisce vari tipi di informazioni su un'istanza di minifilter.

Sintassi

HRESULT FilterInstanceGetInformation(
  [in]  HFILTER_INSTANCE           hInstance,
  [in]  INSTANCE_INFORMATION_CLASS dwInformationClass,
  [out] LPVOID                     lpBuffer,
  [in]  DWORD                      dwBufferSize,
  [out] LPDWORD                    lpBytesReturned
);

Parametri

[in] hInstance

Handle restituito da una chiamata precedente a FilterInstanceCreate.

[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 di .
InstanceFullInformation	Restituisce una struttura INSTANCE_FULL_INFORMATION per l'istanza di .
InstancePartialInformation	Restituisce una struttura INSTANCE_PARTIAL_INFORMATION per l'istanza di .
InstanceAggregateStandardInformation	Restituisce una struttura INSTANCE_AGGREGATE_STANDARD_INFORMATION per l'istanza di . La parte LegacyFilter della struttura viene utilizzata a partire da Windows 8. Questa struttura è 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 FilterInstanceGetInformation ha esito positivo. Questo parametro è obbligatorio e non può essere NULL.

Valore restituito

FilterInstanceGetInformation 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 InstanceAggregateStandardInformation viene specificato per un sistema operativo prima di Windows Vista, FilterInstanceGetInformation restituisce questo valore HRESULT.

Commenti

Dato un handle a un'istanza di minifilter, questa routine restituisce informazioni sull'istanza del minifilter. Il tipo di informazioni sull'istanza restituite è determinato dal parametro dwInformationClass .

FilterInstanceGetInformation è l'equivalente Win32 di FltGetInstanceInformation.