Funzione FindFirstFileNameW (fileapi.h)

Crea un'enumerazione di tutti i collegamenti reali al file specificato. La funzione FindFirstFileNameW restituisce un handle all'enumerazione che può essere utilizzata nelle chiamate successive alla funzione FindNextFileNameW .

Per eseguire questa operazione come operazione transazionata, utilizzare la funzione FindFirstFileNameTransactedW .

Sintassi

HANDLE FindFirstFileNameW(
  [in]      LPCWSTR lpFileName,
  [in]      DWORD   dwFlags,
  [in, out] LPDWORD StringLength,
  [in, out] PWSTR   LinkName
);

Parametri

[in] lpFileName

Nome del file.

Mancia A partire da Windows 10, versione 1607, è possibile acconsentire esplicitamente a rimuovere la limitazione MAX_PATH senza anteporre "\?\". Per informazioni dettagliate, vedere la sezione "Limitazione massima della lunghezza del percorso" di Denominazione di file, percorsi e spazi dei nomi .

 

[in] dwFlags

Riservati; specificare zero (0).

[in, out] StringLength

Dimensioni del buffer a cui punta il parametro LinkName , in caratteri. Se la chiamata non riesce e l'errore restituito dalla funzione GetLastError è ERROR_MORE_DATA (234), il valore restituito da questo parametro è la dimensione a cui deve essere contenuto il buffer a cui punta LinkName .

[in, out] LinkName

Puntatore a un buffer per archiviare il primo nome di collegamento trovato per lpFileName.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un handle di ricerca che può essere usato con la funzione FindNextFileNameW o chiuso con la funzione FindClose .

Se la funzione ha esito negativo, il valore restituito viene INVALID_HANDLE_VALUE (0xffffffff). Per ottenere informazioni sull'errore estese, chiamare la funzione GetLastError .

Commenti

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)	No
SMB 3.0 con condivisioni file di scalabilità orizzontale (SO)	No
File system del volume condiviso cluster (CsvFS)	Sì
Resilient File System (ReFS)	Sì

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	fileapi.h (include Windows.h, WinBase.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll

Vedere anche

Funzioni di gestione file

FindClose

FindFirstFileNameTransactedW

FindNextFileNameW