FltMupGetProviderInfoFromFileObject-Funktion (fltkernel.h)

Artikel
10/26/2024

FltMupGetProviderInfoFromFileObject ruft die Anbieterinformationen ab, die einem Dateiobjekt entsprechen.

Syntax

NTSTATUS FLTAPI FltMupGetProviderInfoFromFileObject(
  PFLT_INSTANCE Instance,
  PFILE_OBJECT  FileObject,
  ULONG         Level,
  PVOID         Buffer,
  PULONG        BufferSize
);

Parameter

Instance

[in] Undurchsichtiger Zeiger auf die Filterinstanz, die diesem Dateiobjekt zugeordnet ist. Dieser Parameter ist erforderlich und kann nicht NULL sein.

FileObject

[in] Zeigen Sie auf das Dateiobjekt, für das die Anbieterinformationen abgerufen werden sollen. Dieser Parameter ist erforderlich und kann nicht NULL sein.

Level

[in] Die Ebene der Informationen, die diese Routine zurückgeben soll. Weitere Informationen zu den möglichen Werten für diesen Parameter finden Sie unter FsRtlMupGetProviderInfoFromFileObject.

Buffer

[out] Zeigen Sie auf einen Puffer, der die Anbieterinformationen empfängt. Die zurückgegebenen Daten basieren auf dem angegebenen Level. Dieser Puffer muss groß genug sein, um die vom Level-Parameter angeforderten Informationen aufzunehmen.

BufferSize

[in/out] Zeigen Sie auf eine Variable, die die Größe des Puffers in Byte angibt, auf den der parameter Buffer verweist. Bei Eingaben gibt diese Variable die Größe des Puffers an. Bei der Ausgabe empfängt diese Variable die Anzahl der Bytes, die in den Puffer geschrieben wurden.

Rückgabewert

FltMupGetProviderInfoFromFileObject gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls wird ein entsprechender NTSTATUS-Code zurückgegeben.

Bemerkungen

Diese Routine ist erforderlich, um den Fall von Anbietern zu behandeln, die sich mit FsRtlRegisterUncProviderExregistrieren. Der Gerätename der Dateiobjekte für diesen Anbieter wäre \Device\Mup.

Filter können diese Routine für die folgenden Zwecke verwenden:

Um bestimmte Umleitungen filtern zu können.
Um einen Redirector zu finden, der ein Dateiobjekt unterstützt, damit er mögliche Fehler in Umleitungen umgehen kann.

Der MUP (mehrere UNC-Anbieter) kann für diesen Aufruf nicht entladen werden.

Der Aufrufer garantiert, dass das FileObject- für die Dauer des Aufrufs gültig ist.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 11, Version 24H2
Header-	fltkernel.h
IRQL-	<= APC_LEVEL

Siehe auch

FsRtlMupGetProviderInfoFromFileObject-

FsRtlRegisterUncProviderEx

Freigeben über