Topics   All   Mac OS X (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server (Not)   Client   Old   Guides   Examples
New in version: 6.2   6.3   6.4   6.5   7.0   7.1   7.2   7.3   7.4   7.5    Statistic  

Files.DiskInfo

Queries information about a volume.

Component Version macOS Windows Server FileMaker Cloud FileMaker iOS SDK
Files 5.0 Yes Yes Yes Yes Yes

MBS( "Files.DiskInfo"; Mode; PathToVolume )

Parameters

Parameter Description Example value
Mode What to return. Can be totalBytes or freeBytes. On Windows you can also pass DriveType for type or FreeBytesAvailable to learn available space for current user. On Mac OS X you can query also fileCount, folderCount, blockSize, totalBlocks or freeBlocks. "freeBytes"
PathToVolume The path to volume. e.g. C:\, \\MyServer\MyDisk\ or /Volumes/testDisk/ or / for root volume on OS X. /

Result

Returns value or error.

Description

Queries information about a volume.
Please pass native path to volume.
For Windows network volumes with \\ syntax, please include trailing backslash.

DriveTypeDescription
UnknownThe drive type cannot be determined.
RemovableThe drive has removable media; for example, a floppy drive, thumb drive, or flash card reader.
FixedThe drive has fixed media; for example, a hard disk drive or flash drive.
RemoteThe drive is a remote (network) drive.
CDROMThe drive is a CD-ROM drive.
RAMDiskThe drive is a RAM disk.

This function requires a native path. Use Path.FileMakerPathToNativePath to convert a FileMaker path to a native path if required. If you like to have the user choose the path, you can use FileDialog functions.
For Server be aware that server has limited permissions and may not be able to access all files on a computer.

Examples

Query free bytes on Mac OS X root volume:

MBS("Files.DiskInfo"; "FreeBytes"; "/")

Query total size of a mounted volume on Mac:

MBS("Files.DiskInfo"; "TotalBytes"; "/Volumes/Ablage1")

Query number of files and folders on Mac:

MBS("Files.DiskInfo"; "FileCount"; "/") & " files and " & MBS("Files.DiskInfo"; "FolderCount"; "/") & " folders."

Query available free bytes on C: for Windows:

MBS("Files.DiskInfo"; "FreeBytesAvailable"; "C:")

Queries size of shared folder in VMWare on Windows:

MBS("Files.DiskInfo"; "TotalBytes"; "\\\\vmware-host\\Shared Folders\\Downloads\\")
// please note the double quoting for backslashes in string constants!

Check drive type on Windows:

MBS( "Files.DiskInfo"; "DriveType"; "C:" )

See also


Files.DirectoryExists   -   Files.FileDisplayName

Feedback: Report problem or ask question.




Links
MBS Xojo PDF Plugins