FltGetFileContext-Funktion (fltkernel.h)
Die FltGetFileContext Routine ruft einen Kontext ab, der für eine Datei von einer bestimmten Minifiltertreiberinstanz festgelegt wurde.
Syntax
NTSTATUS FLTAPI FltGetFileContext(
[in] PFLT_INSTANCE Instance,
[in] PFILE_OBJECT FileObject,
[out] PFLT_CONTEXT *Context
);
Parameter
[in] Instance
Undurchsichtiger Instanzzeiger für den Aufrufer. Dieser Parameter ist erforderlich und kann nicht NULL-werden.
[in] FileObject
Dateiobjektzeiger für die Datei. Dieser Parameter ist erforderlich und kann nicht NULL-werden.
[out] Context
Zeiger auf eine vom Aufrufer zugewiesene Variable, die die Adresse des Kontexts empfängt. Dieser Parameter ist erforderlich und kann nicht auf NULL festgelegt werden.
Rückgabewert
FltGetFileContext gibt STATUS_SUCCESS zurück, wenn der angeforderte Dateikontext erfolgreich zurückgegeben wird. Andernfalls wird ein entsprechender NTSTATUS-Wert zurückgegeben, z. B. einen der folgenden:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_NOT_FOUND | Derzeit wurde in dieser Datei kein Abgleichskontext gefunden, sodass FltMgrContext auf NULL_CONTEXT festlegen. Dies ist ein Fehlercode. |
| STATUS_NOT_SUPPORTED | Dateikontexte werden für diese Datei nicht unterstützt. Dies ist ein Fehlercode. |
Bemerkungen
Weitere Informationen zu Kontexten finden Sie unter Informationen zu Minifilterkontexten.
Ein Minifiltertreiber ruft FltGetFileContext- auf, um den Dateikontext abzurufen, den er für eine bestimmte Datei festgelegt hat.
FltGetFileContext die Verweisanzahl für den Kontext erhöht, auf den der Context-Parameter verweist. Wenn dieser Kontextzeiger nicht mehr benötigt wird, muss der Aufrufer seine Verweisanzahl erhöhen, indem FltReleaseContext-aufgerufen wird. Daher muss jeder erfolgreiche Aufruf von FltGetFileContext durch einen nachfolgenden Aufruf von FltReleaseContextabgeglichen werden.
Rufen Sie FltSetFileContextauf, um einen Dateikontext festzulegen.
Rufen Sie FltAllocateContextauf, um einen neuen Kontext zuzuweisen.
Rufen Sie zum Löschen eines Dateikontexts FltDeleteFileContext oder FltDeleteContext-auf.
Um festzustellen, ob Dateikontexte für eine bestimmte Datei unterstützt werden, rufen Sie FltSupportsFileContexts oder FltSupportsFileContextsExauf.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista |
| Zielplattform- | Universal |
| Header- | fltkernel.h (include Fltkernel.h) |
| Library | FltMgr.lib |
| DLL- | Fltmgr.sys |
| IRQL- | <= APC_LEVEL |