Funzione ZwQueryEaFile (ntifs.h)

Articolo
04/28/2024

La routine ZwQueryEaFile restituisce gli attributi estesi (EAs) associati al file specificato.

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 restituire gli EA del file.

[in] Length

Lunghezza, in byte, del buffer a cui punta 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 EA da eseguire per la 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 EA del file. Questo parametro viene ignorato se 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 nell'elenco EA del file. Se questo parametro è impostato su FALSE, la routine riprende l'analisi da una chiamata precedente a ZwQueryEaFile.

Valore restituito

ZwQueryEaFile restituisce STATUS_SUCCESS o un valore NTSTATUS appropriato, ad esempio:

Valore restituito	Descrizione
STATUS_EAS_NOT_SUPPORTED	Il file system non supporta EAs. Si tratta di un codice di errore.
STATUS_INSUFFICIENT_RESOURCES	Memoria insufficiente per completare l'operazione. Si tratta di un codice di errore.
STATUS_EA_LIST_INCONSISTENT	Il parametro EaList non è formattato correttamente. Si tratta di un codice di errore.

Commenti

La quantità di informazioni restituite da ZwQueryEaFile è basata sulle dimensioni degli EA e sulle dimensioni del buffer a cui punta Buffer . Ovvero, tutti gli EA richiesti vengono scritti nel buffer oppure il buffer viene riempito con tutti gli EA completi se non è sufficientemente grande da contenere tutti gli EA. Solo gli EA completi vengono scritti nel buffer; nessunA EA parziale verrà mai restituita.

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

Condividi tramite