Funzione FindNextFileA (fileapi.h)

Articolo
08/23/2023

Continua una ricerca di file da una chiamata precedente alle funzioni FindFirstFile, FindFirstFileEx o FindFirstFileTransacted .

Sintassi

BOOL FindNextFileA(
  [in]  HANDLE             hFindFile,
  [out] LPWIN32_FIND_DATAA lpFindFileData
);

Parametri

[in] hFindFile

Handle di ricerca restituito da una chiamata precedente alla funzione FindFirstFile o FindFirstFileEx .

[out] lpFindFileData

Puntatore alla struttura WIN32_FIND_DATA che riceve informazioni sul file trovato o sulla sottodirectory.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero e il parametro lpFindFileData contiene informazioni sul file o sulla directory successiva trovata.

Se la funzione ha esito negativo, il valore restituito è zero e il contenuto di lpFindFileData è indeterminato. Per ottenere informazioni sull'errore estese, chiamare la funzione GetLastError .

Se la funzione ha esito negativo perché non è possibile trovare altri file corrispondenti, la funzione GetLastError restituisce ERROR_NO_MORE_FILES.

Commenti

Questa funzione usa gli stessi filtri di ricerca usati per creare l'handle di ricerca passato nel parametro hFindFile . Per altre informazioni, vedere FindFirstFile e FindFirstFileEx.

L'ordine in cui la ricerca restituisce i file, ad esempio l'ordine alfabetico, non è garantito e dipende dal file system. Se i dati devono essere ordinati, l'applicazione deve eseguire l'ordinamento dopo aver ottenuto tutti i risultati.

Nota In rari casi o in un sistema caricato pesantemente, le informazioni sugli attributi dei file nei file system NTFS potrebbero non essere correnti al momento della chiamata di questa funzione. Per assicurarsi di ottenere gli attributi del file system NTFS correnti, chiamare la funzione GetFileInformationByHandle .

L'ordine in cui questa funzione restituisce i nomi di file dipende dal tipo di file system. Con il file system NTFS e i file system CDFS, i nomi vengono in genere restituiti in ordine alfabetico. Con i file system FAT, i nomi vengono in genere restituiti nell'ordine in cui i file sono stati scritti sul disco, che possono essere o meno in ordine alfabetico. Tuttavia, come indicato in precedenza, questi comportamenti non sono garantiti.

Se il percorso punta a un collegamento simbolico, il buffer WIN32_FIND_DATA contiene informazioni sul collegamento simbolico, non sulla destinazione.

In Windows 8 e Windows Server 2012 questa funzione è supportata dalle tecnologie seguenti.

Tecnologia	Supportato
Protocollo SMB (Server Message Block) 3.0	Sì
Failover trasparente SMB 3.0 (TFO)	Sì
SMB 3.0 con condivisioni file di scalabilità orizzontale (SO)	Sì
File system del volume condiviso cluster (CsvFS)	Sì
Resilient File System (ReFS)	Sì

Operazioni transazionate

Se è presente una transazione associata all'handle di enumerazione file, i file restituiti sono soggetti alle regole di isolamento delle transazioni.

Esempio

Per un esempio, vedere Elenco dei file in una directory.

Nota

L'intestazione fileapi.h definisce FindNextFile come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [app desktop \| App UWP]
Server minimo supportato	Windows Server 2003 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	fileapi.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll