FsRtlInsertPerFileContext-Funktion (ntifs.h)

Die FsRtlInsertPerFileContext-Routine ordnet ein FSRTL_PER_FILE_CONTEXT-Objekt einem vom Treiber angegebenen Kontextobjekt für eine Datei zu.

Syntax

NTSTATUS FsRtlInsertPerFileContext(
  [in] PVOID                   *PerFileContextPointer,
  [in] PFSRTL_PER_FILE_CONTEXT Ptr
);

Parameter

[in] PerFileContextPointer

Ein Zeiger auf einen undurchsichtigen Zeiger, der vom FSRTL-Paket (File System Runtime Library) zum Nachverfolgen von Dateikontexten verwendet wird. Verwenden Sie zum Abrufen dieses Zeigers aus einem Dateiobjekt das Makro FsRtlGetPerFileContextPointer .

[in] Ptr

Ein Zeiger auf die treiberspezifische Kontextstruktur.

Rückgabewert

Die FsRtlInsertPerFileContext-Routine gibt STATUS_SUCCESS oder einen entsprechenden Fehlercode zurück, z. B.:

Rückgabecode	Beschreibung
STATUS_INVALID_DEVICE_REQUEST	Das zugrunde liegende Dateisystem unterstützt keine Filterdateikontexte. Sie können das FsRtlSupportsPerFileContexts-Makro verwenden, um zu überprüfen, ob ein Dateisystem pro Dateikontextobjekte unterstützt.
STATUS_INSUFFICIENT_RESOURCES	Das System konnte keine Ressourcen (in der Regel Arbeitsspeicher) zuordnen.

Hinweise

Das FsRtlGetPerFileContextPointer-Makro gibt einen FileContextSupportPointer für eine geöffnete Datei zurück.

Parameter

FileObject

FILE_OBJECT

Ein Zeiger auf ein Dateiobjekt.

Rückgabewert

PVOID

Das FsRtlGetPerFileContextPointer-Makro gibt einen undurchsichtigen Zeiger zurück, der vom FSRTL-Paket (File System Runtime Library) zum Nachverfolgen von Dateikontexten verwendet wird. Das Makro gibt NULL zurück, wenn das Dateisystem die Verwendung von Dateikontextobjekten mit Dateien nicht unterstützt.

Das FsRtlGetPerFileContextPointer-Makro gibt den Zeiger zurück, der an Routinen wie FsRtlInsertPerFileContext, FsRtlLookupPerFileContext und FsRtlRemovePerFileContext übergeben werden soll.

Weitere Informationen zum Verwenden und Erstellen von Kontextobjekten finden Sie unter Nachverfolgen Per-File Kontext in einem Legacy-Dateisystemfiltertreiber.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Zielplattform	Universell
Header	ntifs.h (include FltKernel.h, Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<=APC_LEVEL

Weitere Informationen

FSRTL_PER_FILE_CONTEXT

FsRtlLookupPerFileContext

FsRtlRemovePerFileContext

Nachverfolgen Per-File Kontexts in einem Legacy-Dateisystemfiltertreiber