Funzione GetVolumeInformationA (fileapi.h)

Recupera informazioni sul file system e sul volume associati alla directory radice specificata.

Per specificare un handle durante il recupero di queste informazioni, usare la funzione GetVolumeInformationByHandleW .

Per recuperare lo stato di compressione corrente di un file o di una directory, usare FSCTL_GET_COMPRESSION.

Sintassi

BOOL GetVolumeInformationA(
  [in, optional]  LPCSTR  lpRootPathName,
  [out, optional] LPSTR   lpVolumeNameBuffer,
  [in]            DWORD   nVolumeNameSize,
  [out, optional] LPDWORD lpVolumeSerialNumber,
  [out, optional] LPDWORD lpMaximumComponentLength,
  [out, optional] LPDWORD lpFileSystemFlags,
  [out, optional] LPSTR   lpFileSystemNameBuffer,
  [in]            DWORD   nFileSystemNameSize
);

Parametri

[in, optional] lpRootPathName

Puntatore a una stringa contenente la directory radice del volume da descrivere.

Se questo parametro è NULL, viene utilizzata la radice della directory corrente. È necessaria una barra rovesciata finale. Ad esempio, si specifica \\MyServer\MyShare come "\\MyServer\MyShare\" o l'unità C come "C:\".

[out, optional] lpVolumeNameBuffer

Puntatore a un buffer che riceve il nome di un volume specificato. Le dimensioni del buffer sono specificate dal parametro nVolumeNameSize .

[in] nVolumeNameSize

Lunghezza di un buffer dei nomi di volume, in TCHAR. La dimensione massima del buffer è MAX_PATHs+1.

Questo parametro viene ignorato se il buffer dei nomi del volume non viene fornito.

[out, optional] lpVolumeSerialNumber

Puntatore a una variabile che riceve il numero di serie del volume.

Questo parametro può essere NULL se il numero di serie non è obbligatorio.

Questa funzione restituisce il numero di serie del volume assegnato dal sistema operativo quando viene formattato un disco rigido. Per ottenere a livello di codice il numero di serie del disco rigido assegnato dal produttore, utilizzare la proprietà Strumentazione gestione Windows (WMI) Win32_PhysicalMediaserialNumber.

[out, optional] lpMaximumComponentLength

Puntatore a una variabile che riceve la lunghezza massima, in TCHAR, di un componente del nome file supportato da un file system specificato.

Un componente nome file è la parte di un nome file tra le barre rovesciata.

Il valore archiviato nella variabile a cui *lpMaximumComponentLength punta viene usato per indicare che un file system specificato supporta nomi lunghi. Ad esempio, per un file system FAT che supporta nomi lunghi, la funzione archivia il valore 255, anziché l'indicatore 8.3 precedente. I nomi lunghi possono essere supportati anche nei sistemi che usano il file system NTFS.

[out, optional] lpFileSystemFlags

Puntatore a una variabile che riceve i flag associati al file system specificato.

Questo parametro può essere uno o più dei flag seguenti. Tuttavia, FILE_FILE_COMPRESSION e FILE_VOL_IS_COMPRESSED si escludono a vicenda.

[out, optional] lpFileSystemNameBuffer

Puntatore a un buffer che riceve il nome del file system, ad esempio il file system FAT o il file system NTFS. Le dimensioni del buffer sono specificate dal parametro nFileSystemNameSize .

[in] nFileSystemNameSize

Lunghezza del buffer dei nomi del file system, in TCHARs. La dimensione massima del buffer è MAX_PATH+1.

Questo parametro viene ignorato se il buffer del nome del file system non viene fornito.

Valore restituito

Se tutte le informazioni richieste vengono recuperate, il valore restituito è diverso da zero.

Se non tutte le informazioni richieste vengono recuperate, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Quando un utente tenta di ottenere informazioni su un'unità floppy che non ha un disco floppy o un'unità CD-ROM che non dispone di un disco compatto, il sistema visualizza una finestra di messaggio per l'utente per inserire rispettivamente un disco floppy o un disco compatto. Per evitare che il sistema visualizzi questa finestra di messaggio, chiamare la funzione SetErrorMode con SEM_FAILCRITICALERRORS.

Il flag FILE_VOL_IS_COMPRESSED è l'unico indicatore di compressione basata sul volume. Il nome del file system non viene modificato per indicare la compressione, ad esempio, questo flag viene restituito in un volume DoubleSpace. Quando la compressione è basata su volume, un intero volume viene compresso o meno compresso.

Il flag FILE_FILE_COMPRESSION indica se un file system supporta la compressione basata su file. Quando la compressione è basata su file, i singoli file possono essere compressi o non compressi.

I flag FILE_FILE_COMPRESSION e FILE_VOL_IS_COMPRESSED si escludono a vicenda. Non è possibile restituire entrambi i bit.

Il valore massimo della lunghezza del componente archiviato in lpMaximumComponentLength è l'unico indicatore che un volume supporta file system FAT (o altri nomi di file system) più lunghi del normale. Il nome del file system non viene modificato per indicare il supporto per i nomi di file lunghi.

La funzione GetCompressedFileSize ottiene le dimensioni compresse di un file. La funzione GetFileAttributes può determinare se un singolo file è compresso.

Comportamento del collegamento simbolico

Se il percorso punta a un collegamento simbolico, la funzione restituisce informazioni sul volume per la destinazione.

A partire da Windows 8 e Windows Server 2012, questa funzione è supportata dalle tecnologie seguenti.

SMB non supporta le funzioni di gestione dei volumi.

Operazioni transazionate

Se il volume supporta le transazioni del file system, la funzione restituisce FILE_SUPPORTS_TRANSACTIONS in lpFileSystemFlags.

Requisiti

Vedere anche

Informazioni su KTM

Crittografia file

GetCompressedFileSize

GetFileAttributes

GetVolumeInformationByHandleW

SetErrorMode

SetVolumeLabel

Funzioni di gestione dei volumi