Funzione FsRtlSetKernelEaFile (ntifs.h)

  • Articolo

La routine FsRtlQueryKernelEaFile viene usata per impostare, modificare e/o eliminare i valori dell'attributo esteso (EA) per un file e attendere in modo sincrono il completamento, restituendo un risultato. Imposta la IRP_MN_KERNEL codice secondario 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 buffer di input strutturato FILE_FULL_EA_INFORMATION fornito dal chiamante che contiene i valori degli attributi estesi 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 la normale e l'EA del kernel nella stessa chiamata.
STATUS_INVALID_DEVICE_REQUEST
 La richiesta non è riuscita perché era un dispositivo diretto aperto.
STATUS_SUCCESS
 La richiesta è stata completata.

Commenti

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

Una o più EA del kernel possono essere impostate, modificate e/o eliminate in una singola chiamata a FsRtlSetKernelEaFile. È anche possibile impostare EA normale usando la funzione FsRtlSetKernelEaFile . Per eliminare EA, specificare un EAName con un valore EaValueLength pari a zero. È possibile combinare l'inserimento di nuove, la modifica di esistente o la rimozione di EA in una singola chiamata.

Requisiti

Requisito Valore
Client minimo supportato Windows 8
Server minimo supportato Windows Server 2012
Piattaforma di destinazione Windows
Intestazione ntifs.h

Vedi anche

FsRtlQueryKernelEaFile

ZwQueryEaFile

ZwSetEaFile