FsRtlSetKernelEaFile-Funktion (ntifs.h)

Artikel
12/21/2024

Die Routine FsRtlQueryKernelEaFile wird verwendet, um erweiterte Attributwerte (EXTENDED Attribute, EA) für eine Datei festzulegen, zu ändern und/oder zu löschen, und synchron warten, bis sie abgeschlossen ist, und gibt ein Ergebnis zurück. Er legt den IRP_MN_KERNEL Nebencode fest, mit dem diese API SecureEAs festlegen kann. Dadurch kann der Aufrufer dies von FileObject anstelle eines Handles ausführen.

Syntax

NTSTATUS FsRtlSetKernelEaFile(
  [in] PFILE_OBJECT FileObject,
  [in] PVOID        EaBuffer,
  [in] ULONG        Length
);

Parameter

[in] FileObject

Ein Zeiger auf ein FileObject- zum Senden der QueryEA-Anforderung an.

[in] EaBuffer

Ein Zeiger auf einen vom Aufrufer bereitgestellten, FILE_FULL_EA_INFORMATION-strukturierten Eingabepuffer, der die festzulegenden erweiterten Attributwerte enthält

[in] Length

Gibt die Länge des EA-Puffers an.

Rückgabewert

Die Routine FsRtlSetKernelEaFile erhält den Status des Vorgangs und gibt einen der Statuscodes zurück:

Rückgabecode	Beschreibung
STATUS_EA_LIST_INCONSISTENT	Der EaList Parameter ist nicht ordnungsgemäß formatiert.
STATUS_EAS_NOT_SUPPORTED	Das Dateisystem unterstützt keine erweiterten Attribute.
STATUS_INSUFFICIENT_RESOURCES	Das E/A-Anforderungspaket (IRP) konnte für diese Anforderung nicht zugewiesen werden.
STATUS_INTERMIXED_KERNEL_EA_OPERATION	Die Anforderung kann im gleichen Aufruf keine normalen Und Kernel-EAs nicht miteinander mischen.
STATUS_INVALID_DEVICE_REQUEST	Fehler bei der Anforderung, da es sich um ein direktes Gerät handelte.
STATUS_SUCCESS	Die Anforderung war erfolgreich.

Bemerkungen

Bei dieser Routine wird davon ausgegangen, dass alle übergebenen Puffer aus dem Kernelmodus stammen.

Mindestens ein Kernel-EA kann in einem einzigen Aufruf von FsRtlSetKernelEaFilefestgelegt, geändert und/oder gelöscht werden. Normale EAs können auch mithilfe der FsRtlSetKernelEaFile--Funktion festgelegt werden. Sie löschen EA's, indem Sie eine EAName- mit einem EaValueLength- null angeben. Sie können das Einfügen neuer, Ändern vorhandener oder entfernen von EA in einem einzigen Aufruf miteinander mischen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 8
mindestens unterstützte Server-	Windows Server 2012
Zielplattform-	Fenster
Header-	ntifs.h

Siehe auch

FsRtlQueryKernelEaFile

ZwQueryEaFile-

ZwSetEaFile-

Freigeben über