# Function Reference

# _WinAPI_GetVolumeInformation

Retrieves information about the file system and volume associated with the specified root directory

#include <WinAPIFiles.au3>
_WinAPI_GetVolumeInformation ( [$sRoot = ''] )

## Parameters

$sRoot | [optional] The root directory of the volume to be described. If this parameter is empty string, the root of the current directory is used. A trailing backslash is required. For example, you specify "\\MyServer\MyShare" as "\\MyServer\MyShare\", or the "C" drive as "C:\".

## Return Value

Success: | The array that contains the following information: [0] - The name of a volume. [2] - The serial number of a volume. [1] - The maximum length, in TCHARs, of a file name component that a file system supports. [3] - The flags associated with the file system ($FILE_*). [4] - The name of the file system, for example, "FAT", "NTFS", etc.
Failure: | Sets the @error flag to non-zero, call _WinAPI_GetLastError() to get extended error information.

## Remarks

When a user attempts to get information about a floppy drive that does not have a floppy disk, or a CD-ROM
drive that does not have a compact disc, the system displays a message box for the user to insert a floppy disk
or a compact disc, respectively. To prevent the system from displaying this message box, call the
_WinAPI_SetErrorMode() function with $SEM_FAILCRITICALERRORS.

## See Also

Search GetVolumeInformation in MSDN Library.

## Example

    #include <WinAPIFiles.au3>

    Local $aData = _WinAPI_GetVolumeInformation()

    ConsoleWrite('Volume name: ' & $aData[0] & @CRLF)
    ConsoleWrite('File system: ' & $aData[4] & @CRLF)
    ConsoleWrite('Serial number: ' & $aData[1] & @CRLF)
    ConsoleWrite('File name length: ' & $aData[2] & @CRLF)
    ConsoleWrite('Flags: 0x' & Hex($aData[3]) & @CRLF)