Funzione FindNextVolumeW (fileapi.h)
Continua una ricerca del volume avviata da una chiamata alla funzione FindFirstVolume . FindNextVolume trova un volume per chiamata.
Sintassi
BOOL FindNextVolumeW(
[in] HANDLE hFindVolume,
[out] LPWSTR lpszVolumeName,
[in] DWORD cchBufferLength
);
Parametri
[in] hFindVolume
Handle di ricerca del volume restituito da una chiamata precedente alla funzione FindFirstVolume .
[out] lpszVolumeName
Puntatore a una stringa che riceve il percorso GUID del volume trovato.
[in] cchBufferLength
Lunghezza del buffer che riceve il percorso GUID del volume, in TCHARs.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError. Se non è possibile trovare file corrispondenti, la funzione GetLastError restituisce il codice di errore ERROR_NO_MORE_FILES . In tal caso, chiudere la ricerca con la funzione FindVolumeClose .
Commenti
Dopo aver stabilito l'handle di ricerca chiamando FindFirstVolume, è possibile usare la funzione FindNextVolume per cercare altri volumi.
Non è consigliabile presupporre alcuna correlazione tra l'ordine dei volumi restituiti da queste funzioni e l'ordine dei volumi presenti nel computer. In particolare, non si presuppone alcuna correlazione tra l'ordine del volume e le lettere di unità come assegnato dal BIOS (se presente) o dall'amministratore del disco.
In Windows 8 e Windows Server 2012 questa funzione è supportata dalle tecnologie seguenti.
| Tecnologia | Supportato |
|---|---|
| Protocollo SMB (Server Message Block) 3.0 | No |
| 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) | Sì |
| File system resiliente (ReFS) | Sì |
SMB non supporta le funzioni di gestione dei volumi.
Esempio
Per un esempio, vedere Visualizzazione dei percorsi del volume.
Requisiti
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | fileapi.h (includere Windows.h) |
| Libreria | Kernel32.lib |
| DLL | Kernel32.dll |