FsRtlLookupPerFileContext-Funktion (ntifs.h)

Die FsRtlLookupPerFileContext Routine gibt einen Zeiger auf ein FSRTL_PER_FILE_CONTEXT-Objekt zurück, das einer angegebenen Datei zugeordnet ist.

Syntax

PFSRTL_PER_FILE_CONTEXT FsRtlLookupPerFileContext(
  [in]           PVOID *PerFileContextPointer,
  [in, optional] PVOID OwnerId,
  [in, optional] PVOID InstanceId
);

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, optional] OwnerId

Ein Zeiger auf eine vom Filtertreiber zugewiesene Variable, die den Besitzer der Kontextstruktur pro Datei eindeutig identifiziert. Das Format dieser Variablen ist filtertreiberspezifisch. Dieser Parameter ist optional, muss jedoch nichtNULL- sein, wenn InstanceId- nichtNULL-ist.

[in, optional] InstanceId

Ein Zeiger auf eine vom Filtertreiber zugewiesene Variable, die verwendet werden kann, um zwischen Dateikontextstrukturen zu unterscheiden, die vomselben Filtertreiber erstellt werden. Das Format dieser Variablen ist filtertreiberspezifisch. Dieser Parameter ist optional.

Rückgabewert

Ein Zeiger auf die erste FSRTL_PER_FILE_CONTEXT Struktur, die der OwnerId- entspricht, und InstanceId-, falls angegeben, oder NULL-, wenn keine Übereinstimmung gefunden wird oder das Dateisystem keine Dateikontexte unterstützt.

Bemerkungen

Wenn Sie OwnerID und InstanceId-nicht angeben, kann ein Filtertreiber nach dem ersten Kontext suchen, der einer Datei zugeordnet ist.

Wenn das Dateisystem keine Kontextobjekte pro Datei unterstützt, wird NULL- zurückgegeben. Verwenden Sie die FsRtlSupportsPerFileContexts Makro, um zu bestimmen, ob ein Dateisystem Kontextobjekte pro Datei unterstützt.

Anforderungen

Siehe auch

FSRTL_PER_FILE_CONTEXT

FsRtlGetPerFileContextPointer

FsRtlInsertPerFileContext-

FsRtlRemovePerFileContext

Nachverfolgen Per-File Kontexts in einem älteren Dateisystemfiltertreiber