Funzione FindNextFileA (fileapi.h)

Articolo
11/20/2024

Continua una ricerca di file da una chiamata precedente alle funzioni di FindFirstFile, FindFirstFileExo funzioni 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 sottodirectory.

Valore restituito

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

Se la funzione ha esito negativo, il valore restituito è zero e il contenuto di lpFindFileData sono indeterminate. Per ottenere informazioni estese sull'errore, 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.

Osservazioni

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 pesantemente caricato, le informazioni sull'attributo file nei file system NTFS potrebbero non essere correnti al momento della chiamata di questa funzione. Per assicurarsi di ottenere gli attributi correnti del file system NTFS, 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 potrebbero o non essere 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	Sostenuto
Protocollo SMB (Server Message Block) 3.0	Sì
SMB 3.0 Transparent Failover (TFO)	Sì
SMB 3.0 con condivisioni file con scalabilità orizzontale (SO)	Sì
Cluster Shared Volume File System (CsvFS)	Sì
Resilient File System (ReFS)	Sì

operazioni transazionate

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

Esempi

Per un esempio, vedere Elencare i 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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [app desktop \| App UWP]
server minimo supportato	Windows Server 2003 [app desktop \| App UWP]
piattaforma di destinazione	Finestre
intestazione	fileapi.h (include Windows.h)
libreria	Kernel32.lib
dll	Kernel32.dll