Funzione FindNextVolumeA (winbase.h)

  • Articolo

Continua una ricerca di volumi avviata da una chiamata alla funzione FindFirstVolume . FindNextVolume trova un volume per ogni chiamata.

Sintassi

BOOL FindNextVolumeA(
  [in]  HANDLE hFindVolume,
  [out] LPSTR  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 TCHAR.

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 presupporre alcuna correlazione tra l'ordine del volume e le lettere di unità assegnate 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 di scalabilità orizzontale (SO) No
File system del volume condiviso cluster (CsvFS) Sì
Resilient File System (ReFS) Sì
 

SMB non supporta le funzioni di gestione dei volumi.

Esempio

Per un esempio, vedere Visualizzazione dei percorsi del volume.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione winbase.h (include Windows.h)
Libreria Kernel32.lib
DLL Kernel32.dll

Vedere anche

FindFirstVolume

FindVolumeClose

Cartelle montate

Funzioni di gestione dei volumi