Funzione FindNextFileNameW (fileapi.h)

Continua a enumerare i collegamenti rigidi a un file usando l'handle restituito da una chiamata riuscita alla funzione FindFirstFileNameW .

Sintassi

BOOL FindNextFileNameW(
  [in]      HANDLE  hFindStream,
  [in, out] LPDWORD StringLength,
  [in, out] PWSTR   LinkName
);

Parametri

[in] hFindStream

Handle per l'enumerazione restituita da una chiamata riuscita a FindFirstFileNameW.

[in, out] StringLength

Dimensioni del parametro LinkName , in caratteri. Se questa chiamata ha esito negativo e l'errore è ERROR_MORE_DATA, il valore restituito da questo parametro è la dimensione che LinkName deve contenere tutti i dati.

[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 è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero (0). Per informazioni dettagliate sull'errore, chiamare GetLastError.

Se non sono disponibili file corrispondenti, la funzione GetLastError restituisce ERROR_HANDLE_EOF.

Commenti

Se la funzione restituisce TRUE, sono disponibili collegamenti più rigidi da enumerare.

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

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

Requisiti

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

Vedere anche

Funzioni di gestione file

FindClose

FindFirstFileNameW