FilterGetInformation-Funktion (fltuser.h)

Artikel
08/23/2023

Die FilterGetInformation-Funktion gibt verschiedene Arten von Informationen zu einem Minifilter zurück.

Syntax

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

Parameter

[in] hFilter

Handle, das von einem vorherigen Aufruf der FilterCreate-Funktion zurückgegeben wurde.

[in] dwInformationClass

Typ der angeforderten Informationen. Dieser Parameter muss einen der folgenden Werte aufweisen.

Wert	Bedeutung
FilterFullInformation	Gibt eine FILTER_FULL_INFORMATION-Struktur für den Minifilter zurück.
FilterAggregateBasicInformation	Gibt eine FILTER_AGGREGATE_BASIC_INFORMATION-Struktur für den Minifilter zurück. Dieser dwInformationClass-Wert ist ab Microsoft Windows Server 2003 mit SP1 und Microsoft Windows XP mit SP2 mit Filter-Manager-Rollup verfügbar. Weitere Informationen zum Filter-Manager-Rolluppaket für Windows XP mit SP2 finden Sie in der Microsoft Knowledge Base im Artikel 914882 " Das Filter-Manager-Rolluppaket für Windows XP SP2".
FilterAggregateStandardInformation	Gibt eine FILTER_AGGREGATE_STANDARD_INFORMATION-Struktur für jeden Minifilter zurück. Der LegacyFilter-Teil der Struktur wird nicht verwendet. Dieser dwInformationClass-Wert ist ab Windows Vista verfügbar.

[out] lpBuffer

Zeiger auf einen vom Aufrufer zugewiesenen Puffer, der die angeforderten Informationen empfängt. Der Typ der im Puffer zurückgegebenen Informationen wird durch den dwInformationClass-Parameter definiert.

[in] dwBufferSize

Größe des Puffers, auf den der lpBuffer-Parameter verweist, in Byte. Der Aufrufer sollte diesen Parameter entsprechend der angegebenen dwInformationClass festlegen.

[out] lpBytesReturned

Zeiger auf eine vom Aufrufer zugewiesene Variable, die die Anzahl von Bytes empfängt, die im Puffer zurückgegeben werden, auf den lpBuffer zeigt, wenn der Aufruf von FilterGetInformation erfolgreich ist. Dieser Parameter ist erforderlich und darf nicht NULL sein.

Rückgabewert

FilterGetInformation gibt bei erfolgreicher Ausführung S_OK zurück. Andernfalls wird ein HRESULT-Fehlerwert zurückgegeben, z. B. einer der folgenden:

Rückgabecode	Beschreibung
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	Der Puffer, auf den lpBuffer verweist, ist nicht groß genug, um die angeforderten Informationen zu enthalten. Wenn dieser Wert zurückgegeben wird, enthält lpBytesReturned die Größe des Puffers in Bytes, der für die angegebene dwInformationClass-Struktur erforderlich ist.
HRESULT_FROM_WIN32(ERROR_INVALID_PARAMETER)	Für den dwInformationClass-Parameter wurde ein ungültiger Wert angegeben. Wenn beispielsweise FilterAggregateStandardInformation für ein Betriebssystem vor Windows Vista angegeben ist, gibt FilterGetInformation diesen HRESULT-Wert zurück.