FsRtlSetKernelEaFile-Funktion (ntifs.h)

  • Artikel

Die Routinemäßige FsRtlQueryKernelEaFile wird verwendet, um EA-Werte (Extended Attribute) für eine Datei festzulegen, zu ändern und/oder zu löschen und synchron zu warten, bis sie abgeschlossen ist, wodurch ein Ergebnis zurückgegeben wird. Es legt den IRP_MN_KERNEL Nebencode fest, mit dem diese API SecureEAs festlegen kann. Dadurch kann der Aufrufer dies nach 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 , an das die QueryEA-Anforderung gesendet werden soll.

[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 FsRtlSetKernelEaFile-Routine empfängt die status des Vorgangs und gibt einen der status Codes 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 zugeordnet werden.
STATUS_INTERMIXED_KERNEL_EA_OPERATION
 Die Anforderung kann nicht normal und Kernel-EAs im selben Aufruf miteinander vermischen.
STATUS_INVALID_DEVICE_REQUEST
 Die Anforderung ist fehlgeschlagen, da ein direktes Gerät geöffnet war.
STATUS_SUCCESS
 Die Anforderung wurde erfolgreich gesendet.

Hinweise

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

Ein oder mehrere Kernel-EAs können in einem einzigen Aufruf von FsRtlSetKernelEaFile festgelegt, geändert und/oder gelöscht werden. Normale EA's können auch mithilfe der FsRtlSetKernelEaFile-Funktion festgelegt werden. Sie löschen EAs, indem Sie einen EAName mit einer EaValueLength von 0 angeben. Sie können das Einfügen von neuen, das Ändern vorhandener oder das Entfernen von EAs in einem einzigen Aufruf miteinander verbinden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8
Unterstützte Mindestversion (Server) Windows Server 2012
Zielplattform Windows
Kopfzeile ntifs.h

Weitere Informationen

FsRtlQueryKernelEaFile

ZwQueryEaFile

ZwSetEaFile