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)