Funzione FsRtlSetKernelEaFile (ntifs.h)

Articolo
12/21/2024

La routine FsRtlQueryKernelEaFile viene usata per impostare, modificare ed eliminare valori di attributo esteso (EA) per un file e attendere in modo sincrono il completamento, restituendo un risultato. Imposta il codice secondario IRP_MN_KERNEL che consente a questa API di impostare SecureEAs. In questo modo il chiamante può eseguire questa operazione da FileObject anziché da un handle.

Sintassi

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

Parametri

[in] FileObject

Puntatore a un FileObject a cui inviare la richiesta QueryEA.

[in] EaBuffer

Puntatore a un chiamante fornito, FILE_FULL_EA_INFORMATIONbuffer di input strutturato che contiene i valori estesi dell'attributo da impostare

[in] Length

Specifica la lunghezza del buffer EA.

Valore restituito

La routine FsRtlSetKernelEaFile riceve lo stato dell'operazione e restituisce uno dei codici di stato:

Codice restituito	Descrizione
STATUS_EA_LIST_INCONSISTENT	Il parametro EaList non è formattato correttamente.
STATUS_EAS_NOT_SUPPORTED	Il file system non supporta gli attributi estesi.
STATUS_INSUFFICIENT_RESOURCES	Impossibile allocare il pacchetto di richiesta di I/O per questa richiesta.
STATUS_INTERMIXED_KERNEL_EA_OPERATION	La richiesta non può combinare normali e kernel EA nella stessa chiamata.
STATUS_INVALID_DEVICE_REQUEST	La richiesta non è riuscita perché era un dispositivo diretto aperto.
STATUS_SUCCESS	La richiesta ha avuto esito positivo.

Osservazioni

Questa routine presuppone che tutti i buffer passati provenano dalla modalità kernel.

È possibile impostare, modificare ed eliminare una o più EA del kernel in una singola chiamata a FsRtlSetKernelEaFile. È anche possibile impostare EA normale usando la funzione FsRtlSetKernelEaFile. È possibile eliminare EA specificando un EAName con un EaValueLength pari a zero. È possibile combinare l'inserimento di nuovi, la modifica o la rimozione di EA in una singola chiamata.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 8
server minimo supportato	Windows Server 2012
piattaforma di destinazione	Finestre
intestazione	ntifs.h

Vedere anche

FsRtlQueryKernelEaFile

ZwQueryEaFile

ZwSetEaFile

Condividi tramite