Funzione FindFirstVolumeW (fileapi.h)
Recupera il nome di un volume in un computer. FindFirstVolume viene usato per iniziare a analizzare i volumi di un computer.
Sintassi
HANDLE FindFirstVolumeW(
[out] LPWSTR lpszVolumeName,
[in] DWORD cchBufferLength
);
Parametri
[out] lpszVolumeName
Puntatore a un buffer che riceve una stringa con terminazione null che specifica un percorso GUID del volume per il primo volume trovato.
[in] cchBufferLength
Lunghezza del buffer da ricevere il percorso GUID del volume, in TCHARs.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è un handle di ricerca usato in una chiamata successiva alle funzioni FindNextVolume e FindVolumeClose .
Se la funzione non trova volumi, il valore restituito è il codice di errore INVALID_HANDLE_VALUE . Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
La funzione FindFirstVolume apre un handle di ricerca del volume e restituisce informazioni sul primo volume trovato in un computer. Dopo aver stabilito l'handle di ricerca, è possibile usare la funzione FindNextVolume per cercare altri volumi. Quando l'handle di ricerca non è più necessario, chiuderlo usando la funzione FindVolumeClose .
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 |