Unmounts and ejects a remote or removable disk.
TrFile_UnmountDisk ( switches ; diskname )
|switches||not used, reserved for future use. Leave blank or put "-Unused"|
|diskname||the name of the disk to be unmounted or ejected|
Data type returned
The returned result is an error code. An error always starts with 2 dollars, followed by the error code. You should always check for errors. Returned error codes can be:
|0||no error||The disk was ejected.|
|$$-35||nsVolErr||No such volume (Wrong disk name or not mounted).|
|$$-47||fBsyErr||The disk is in use.|
|$$-5010||afpFileBusy||Can’t eject as the disk is being shared.|
Other errors may be returned.
Troi File Plug-in 2.0
FileMaker Pro 16 to FileMaker Pro 2023
On macOS it is possible to have multiple disks with the same name. In this case the function will unmount the first disk that matches the diskname.
Since version 2.6 this function is also available on Windows. However it does not physically eject removable media, like a CD-ROM.
Set Field [ result ; TrFile_UnmountDisk ( "-Unused"; "Mac HD:" ) ]
This will eject the hard disk “Mac HD”, provided it is not the startup disk. On Windows an example is:
Set Field [ result ; TrFile_UnmountDisk ( "-Unused"; "K:" ) ]
This will unmount the mapped drive “K:”
We assume that in your FileMaker file the following fields are defined:
gErrorCode Global, number gDiskName Global, text
gFilePath should contain the path to the disk, for example “Archive CD:” (Mac). In a script add the following script step, which will eject the disk specified by gDiskName:
Set Field [ gErrorCode ; TrFile_UnmountDisk ( "-Unused" ; gDiskName ) ]
Used in example file
Related script step