Freigeben über

FsRtlInsertPerFileContext-Funktion (ntifs.h)

  • Artikel

Die FsRtlInsertPerFileContext Routine ordnet ein FSRTL_PER_FILE_CONTEXT Objekt einem treiberspezifischen 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. Um diesen Zeiger aus einem Dateiobjekt abzurufen, verwenden Sie das FsRtlGetPerFileContextPointer Makro.

[in] Ptr

Ein Zeiger auf die treiberspezifische Kontextstruktur.

Rückgabewert

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

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

Bemerkungen

Das FsRtlGetPerFileContextPointer-Makro gibt ein 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übergeben werden soll, und FsRtlRemovePerFileContext.

Weitere Informationen zur Verwendung und Erstellung von Kontextobjekten finden Sie unter Tracking Per-File Context in einem Legacy File System Filter Driver.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows Vista
Zielplattform- Universal
Header- ntifs.h (include FltKernel.h, Ntifs.h)
Library NtosKrnl.lib
DLL- NtosKrnl.exe
IRQL- <=APC_LEVEL

Siehe auch

FSRTL_PER_FILE_CONTEXT

FsRtlLookupPerFileContext

FsRtlRemovePerFileContext

Nachverfolgen Per-File Kontexts in einem älteren Dateisystemfiltertreiber