Funzione ZwQueryEaFile (ntifs.h)

Articolo
12/21/2024

ZwQueryEaFile routine restituisce gli attributi estesi 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 chiamante fornito FILE_FULL_EA_INFORMATIONbuffer di output strutturato in cui restituire gli EA del file.

[in] Length

Lunghezza, in byte, del buffer a cui buffer punta.

[in] ReturnSingleEntry

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

[in, optional] EaList

Puntatore a un chiamante fornito FILE_GET_EA_INFORMATIONbuffer di input strutturato che specifica gli EA su cui eseguire una 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 le EA. 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.

Osservazioni

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

Fabbisogno

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)

Vedere anche

FILE_FULL_EA_INFORMATION

FILE_GET_EA_INFORMATION

ZwSetEaFile

Condividi tramite