Funzione FindNextVolumeW (fileapi.h)

  • Articolo

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

Vedere anche

FindFirstVolume

FindVolumeClose

Cartelle montate

Funzioni di gestione dei volumi