FltGetFileContext-Funktion (fltkernel.h)
Die FltGetFileContext-Routine ruft einen Kontext ab, der von einem bestimmten Minifiltertreiber instance für eine Datei festgelegt wurde.
Syntax
NTSTATUS FLTAPI FltGetFileContext(
[in] PFLT_INSTANCE Instance,
[in] PFILE_OBJECT FileObject,
[out] PFLT_CONTEXT *Context
);
Parameter
[in] Instance
Undurchsichtiger instance Zeiger für den Aufrufer. Dieser Parameter ist erforderlich und darf nicht NULL sein.
[in] FileObject
Dateiobjektzeiger für die Datei. Dieser Parameter ist erforderlich und darf nicht NULL sein.
[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. einer der folgenden:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_NOT_FOUND | Zu diesem Zeitpunkt wurde kein übereinstimmenden Kontext für diese Datei gefunden, sodass FltMgrKontext auf NULL_CONTEXT festgelegt hat. Dies ist ein Fehlercode. |
| STATUS_NOT_SUPPORTED | Dateikontexte werden für diese Datei nicht unterstützt. Dies ist ein Fehlercode. |
Hinweise
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 erhöht die Verweisanzahl für den Kontext, auf den der Context-Parameter verweist. Wenn dieser Kontextzeiger nicht mehr benötigt wird, muss der Aufrufer seine Verweisanzahl durch Aufrufen von FltReleaseContext verringern. Daher muss jeder erfolgreiche Aufruf von FltGetFileContext durch einen nachfolgenden Aufruf von FltReleaseContext abgeglichen werden.
Um einen Dateikontext festzulegen, rufen Sie FltSetFileContext auf.
Um einen neuen Kontext zuzuordnen, rufen Sie FltAllocateContext auf.
Um einen Dateikontext zu löschen, rufen Sie FltDeleteFileContext oder FltDeleteContext auf.
Um zu ermitteln, ob Dateikontexte für eine bestimmte Datei unterstützt werden, rufen Sie FltSupportsFileContexts oder FltSupportsFileContextsEx auf.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Zielplattform | Universell |
| Header | fltkernel.h (include Fltkernel.h) |
| Bibliothek | FltMgr.lib |
| DLL | Fltmgr.sys |
| IRQL | <= APC_LEVEL |