Funzione FindFirstVolumeW (fileapi.h)

  • Articolo

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

Vedere anche

FindNextVolume

FindVolumeClose

Cartelle montate

Funzioni di gestione dei volumi