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 aber nicht NULL sein, wenn InstanceId nicht NULL ist.

[in, optional] InstanceId

Ein Zeiger auf eine vom Filtertreiber zugewiesene Variable, die verwendet werden kann, um zwischen Dateikontextstrukturen zu unterscheiden, die vom gleichen 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 mit der OwnerId und InstanceId übereinstimmt, sofern angegeben, oder NULL , wenn keine Übereinstimmung gefunden wird oder das Dateisystem keine Dateikontexte unterstützt.

Hinweise

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

Wenn das Dateisystem keine Dateikontextobjekte unterstützt, wird NULL zurückgegeben. Verwenden Sie das Makro FsRtlSupportsPerFileContexts , um zu bestimmen, ob ein Dateisystem Dateikontextobjekte unterstützt.

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

FsRtlGetPerFileContextPointer

FsRtlInsertPerFileContext

FsRtlRemovePerFileContext

Nachverfolgen Per-File Kontexts in einem Legacy-Dateisystemfiltertreiber