Funzione ZwQueryEaFile (ntifs.h)

  • Articolo

La routine ZwQueryEaFile restituisce informazioni sui valori EA (Extended-Attribute) per un file.

Sintassi

NTSTATUS ZwQueryEaFile(
  [in]           HANDLE           FileHandle,
  [out]          PIO_STATUS_BLOCK IoStatusBlock,
  [out]          PVOID            Buffer,
  [in]           ULONG            Length,
  [in]           BOOLEAN          ReturnSingleEntry,
  [in, optional] PVOID            EaList,
  [in]           ULONG            EaListLength,
  [in, optional] PULONG           EaIndex,
  [in]           BOOLEAN          RestartScan
);

Parametri

[in] FileHandle

Handle per il file in cui deve essere eseguita l'operazione.

[out] IoStatusBlock

Puntatore a una struttura IO_STATUS_BLOCK che riceve lo stato di completamento finale e altre informazioni sull'operazione richiesta.

[out] Buffer

Puntatore a un buffer di output strutturato FILE_FULL_EA_INFORMATION fornito dal chiamante, in cui devono essere restituiti i valori degli attributi estesi.

[in] Length

Lunghezza, in byte, del buffer a cui punta il parametro Buffer .

[in] ReturnSingleEntry

Impostare su TRUE se ZwQueryEaFile deve restituire solo la prima voce trovata.

[in, optional] EaList

Puntatore a un buffer di input strutturato FILE_GET_EA_INFORMATION fornito dal chiamante, che specifica gli attributi estesi su cui eseguire query. Questo parametro è facoltativo e può essere NULL.

[in] EaListLength

Lunghezza, in byte, del buffer a cui punta il parametro EaList .

[in, optional] EaIndex

Indice della voce in corrispondenza della quale deve iniziare l'analisi dell'elenco di attributi estesi del file. Questo parametro viene ignorato se il parametro EaList punta a un elenco non vuoto. Questo parametro è facoltativo e può essere NULL.

[in] RestartScan

Impostare su TRUE se ZwQueryEaFile deve iniziare l'analisi alla prima voce dell'elenco di attributi estesi del file. Se questo parametro è impostato su FALSE, la routine riprende l'analisi da una chiamata precedente a ZwQueryEaFile.

Valore restituito

ZwQueryEaFile restituisceSTATUS_SUCCESS o un valore NTSTATUS appropriato, ad esempio:

Valore restituito Descrizione
STATUS_EAS_NOT_SUPPORTED
 Il file system non supporta gli attributi estesi. Si tratta di un codice di errore.
STATUS_INSUFFICIENT_RESOURCES
 La routine ZwQueryEaFile ha rilevato un errore di allocazione del pool. Si tratta di un codice di errore.
STATUS_EA_LIST_INCONSISTENT
 Il parametro EaList non è formattato correttamente. Si tratta di un codice di errore.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000
Piattaforma di destinazione Universale
Intestazione ntifs.h (include FltKernel.h, Ntifs.h)
Libreria NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Regole di conformità DDI HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Vedi anche

FILE_FULL_EA_INFORMATION

FILE_GET_EA_INFORMATION

ZwSetEaFile