Topics
All
MacOS
(Only)
Windows
(Only)
Linux
(Only, Not)
iOS
(Only, Not)
Components
Crossplatform Mac & Win
Server
Client
Old
Deprecated
Guides
Examples
Videos
New in version:
9.3
9.4
9.5
10.0
10.1
10.2
10.3
10.4
10.5
10.6
Statistic
FMM
Blog
Files.DiskInfo
Queries information about a volume.
| Component | Version | macOS | Windows | Linux | Server | FileMaker iOS SDK |
| Files | 5.0 | Yes | Yes | Yes | Yes | Yes |
Parameters
| Parameter | Description | Example |
|---|---|---|
| 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 macOS 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 macOS. | / |
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.
| DriveType | Description |
| Unknown | The drive type cannot be determined. |
| Removable | The drive has removable media; for example, a floppy drive, thumb drive, or flash card reader. |
| Fixed | The drive has fixed media; for example, a hard disk drive or flash drive. |
| Remote | The drive is a remote (network) drive. |
| CDROM | The drive is a CD-ROM drive. |
| RAMDisk | The 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 macOS 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
Blog Entries
- MBS FileMaker Plugin, version 7.3pr4
- MBS FileMaker Plugin 5.0 for OS X/Windows - More than 3000 Functions In One Plugin
- MBS FileMaker Plugin, version 5.0pr10
Release notes
- Version 7.3
- Added new option DriveType for Files.DiskInfo on Windows.
Created 3th February 2015, last changed 10th August 2020
Files.DirectoryExists - Files.FileDisplayName
Feedback: Report problem or ask question.
Links
MBS Xojo blog
