FltRequestSecurityInfoOnCreateCompletion-Funktion (fltkernel.h)
Ein Minifilter ruft FltRequestSecurityInfoOnCreateCompletion während der Dateivorerstellung auf, um anzufordern, dass das Dateisystem Dateisicherheitsinformationen für den Abruf während der Nacherstellung speichert.
Syntax
NTSTATUS FLTAPI FltRequestSecurityInfoOnCreateCompletion(
PFLT_FILTER Filter,
PFLT_CALLBACK_DATA Data,
SECURITY_INFORMATION SecurityInformation
);
Parameter
Filter
Undurchsichtiger Filterzeiger, der den Minifiltertreiber eindeutig identifiziert.
Data
Zeiger auf die FLT_CALLBACK_DATA Rückrufdaten, die den E/A-Erstellungsvorgang darstellen.
SecurityInformation
SECURITY_INFORMATION Wert, der die Informationen angibt, die als Kombination aus mindestens einer der folgenden Optionen festgelegt werden sollen.
| Wert | Bedeutung |
|---|---|
| OWNER_SECURITY_INFORMATION | Gibt an, dass der Besitzerbezeichner des Objekts festgelegt werden soll. Erfordert WRITE_OWNER Zugriff. |
| GROUP_SECURITY_INFORMATION | Gibt an, dass der primäre Gruppenbezeichner des Objekts festgelegt werden soll. Erfordert WRITE_OWNER Zugriff. |
| DACL_SECURITY_INFORMATION | Gibt an, dass die diskretionäre Zugriffssteuerungsliste (DACL) des Objekts festgelegt werden soll. Erfordert WRITE_DAC Zugriff. |
| SACL_SECURITY_INFORMATION | Gibt an, dass die System-ACL (SACL) des Objekts festgelegt werden soll. Erfordert ACCESS_SYSTEM_SECURITY Zugriff. |
Rückgabewert
FltRequestSecurityInfoOnCreateCompletion kann einen der folgenden Werte zurückgeben:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_SUCCESS | Das Dateisystem hat die angeforderten Dateisicherheitsinformationen erfolgreich gespeichert. |
| STATUS_INSUFFICIENT_RESOURCES | FltRequestSecurityInfoOnCreateCompletion konnte nicht genügend Arbeitsspeicher zuweisen, in dem die angeforderten Dateiinformationen gespeichert werden konnten. |
| STATUS_INVALID_PARAMETER_2 | Das bereitgestellte Rückrufdatenobjekt war kein IRP-basierter Erstellungsvorgang. |
Hinweise
Der Minifilter kann die Dateiinformationen abrufen, indem während der Nacherstellung FltRetrieveFileInfoOnCreateCompletionEx oder FltRetrieveFileInfoOnCreateCompletion aufgerufen wird. Die Leistung eines Minifilters ist in der Regel besser, wenn er Dateiinformationen auf diese Weise anfordert und abruft, anstatt Dateiinformationen zu einem späteren Zeitpunkt abzufragen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 11, Version 24H2 |
| Kopfzeile | fltkernel.h (include Fltkernel.h) |