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
Nachverfolgen Per-File Kontexts in einem Legacy-Dateisystemfiltertreiber