Funzione FsRtlSetKernelEaFile (ntifs.h)
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 |
---|---|
|
Il parametro EaList non è formattato correttamente. |
|
Il file system non supporta gli attributi estesi. |
|
Impossibile allocare il pacchetto di richiesta di I/O per questa richiesta. |
|
La richiesta non può combinare la normale e l'EA del kernel nella stessa chiamata. |
|
La richiesta non è riuscita perché era un dispositivo diretto aperto. |
|
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 |