Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Ein Minifilter ruft FltRequestSecurityInfoOnCreateCompletion während der Dateivorerstellung auf, um anzufordern, dass das Dateisystem Dateisicherheitsinformationen für den Abruf während der Erstellung 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
Zeigen Sie auf die FLT_CALLBACK_DATA Rückrufdaten, die den E/A-Erstellungsvorgang darstellen.
SecurityInformation
SECURITY_INFORMATION Wert, der die festzulegenden Informationen als Kombination aus einer oder mehreren der folgenden Werte angibt.
| 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 zuordnen, in dem die angeforderten Dateiinformationen gespeichert werden können. |
| STATUS_INVALID_PARAMETER_2 | Das bereitgestellte Rückrufdatenobjekt war kein IRP-basierter Erstellungsvorgang. |
Bemerkungen
Der Minifilter kann die Dateiinformationen abrufen, indem FltRetrieveFileInfoOnCreateCompletionEx oder FltRetrieveFileInfoOnCreateCompletion während der Nachbearbeitung 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 |
|---|---|
| mindestens unterstützte Client- | Windows 11, Version 24H2 |
| Header- | fltkernel.h (include Fltkernel.h) |