 |
Mount Disk |
Connect to a shared network volume, by mounting the disk. You can then for example read or save files on this disk.
Syntax
Mount Disk [ Select ; Result (error) ; Zone ; Server ; Disk ; User name ;
Password ; Reuse drive letter ]
Options
| Select entire contents | replaces the entire contents of a field with the result. If not checked the result replaces the currently selected portion of the field |
| Result (error) | an error code |
| Zone | (optional) the name of the AppleTalk zone (on Windows this parameter is not used) |
| Server | on Mac the name of the Server, on Windows the UNC name of the share |
| Disk | on Mac the name of the disk, on Windows (optional) the drive letter to use |
| User name | (optional) the name of the user (if empty guest access is tried) |
| Password | (optional) the password of this user |
| Reuse drive letter | (default) if the network disk already is mapped reuse that drive letter (on Windows) |
Returned Result
Data type returned
Error code
Result
On macOS The returned result is an error code. If no error occurs a zero is returned.
On Windows the returned result is the drive letter or an error code. An example drive letter can be: “F:”
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 mounted |
| $$-35 | nsVolErr | no such volume, disk not found |
| $$-50 | paramErr | parameter error, check if the supplied parameters are correct |
| $$-5023 | the user is not authorized for this volume | |
| $$-5000 | insufficient access privileges for operation | |
| $$67 | (Windows) the specified UNC name is invalid or can not be found | |
| $$1200 | (Windows) the specified drive letter is invalid. Enter a valid drive letter, like “K:” | |
| $$2250 | (Windows) not connected to a network |
Originated in
Troi File Plug-in 9.0
Compatibility
FileMaker Pro 16 to FileMaker Pro 2023
Considerations
Due to differences in operating systems this function behaves a bit different on Mac compared to Windows. On Windows there is no zone name for example. See the platform specific examples below.
On macOS the plug-in also supports URL style AFP (AppleTalk File Protocol) servers. See also the examples below.
Regarding sending passwords on macOS: the plug-in always tries to use 2 way encrypted passwords.
On Windows the “server” parameter should be a UNC name, formatted like “\\servername\share”. Also on Windows the parameter “disk” indicates the drive letter to use, like “K:”. If empty the function picks a free drive letter.
IMPORTANT On some Windows implementations the username and password parameter have been switched. If you get a authorization error, try reversing the username and password!
After mounting the shared disk icon should appear on your desktop (on macOS) or in the My Computer folder (on Windows). Depending on your access privileges, you can copy files, create folders and use items on the shared disk as if they were on your local hard disk.
Example
macOS :
Mount Disk [ Select ; $ErrorCode ; "MacZone" ; "McServer" ; "Shared Disk" ; "George" ; "secret" ]Mount Disk [ Select ; $ErrorCode ; "" ; "McServer" ; "Guest folder" ]The first step will mount the hard disk “Shared Disk” of server “McServer” in zone “MacZone” using the user name “George” with password “secret”.
The second step will mount the volume “Guest folder” of server “McServer” using guest access. As the zone parameter is empty, the server can be in any zone.
The plug-in also supports URL style AFP servers names. For example a server on the intranet:
Mount Disk [ Select ; $ErrorCode ; "" ; "afp://192.168.1.55" ; "Shared Disk" ]The plug-in also supports URL style WebDAV server names on macOS . For example an iDisk server:
Mount Disk [ Select ; $ErrorCode ; "" ; "http://idisk.mac.com/youridiskname" ; "" ]You can also connect to servers on the public Internet, for example:
Mount Disk [ Select ; $ErrorCode ; "" ; "afp://tramp.tr.fh-hannover.de" ; "Oeffentliche_Software" ]On Windows:
Mount Disk [ Select ; $ErrorCode ; "unused zone" ; "\\Troi Server\Projects" ;
"" ; "George" ; "secret" ; Reuse drive letter ]Mount Disk [ Select ; $ErrorCode ; "unused zone" ; "\\Troi Server\Projects" ; "Z:" ]The first step will mount the share “Projects” of server “Troi Server” using the user name “George” with password “secret”. The second step will mount the same share using guest access, and mounting it as drive “Z:”.
Related script step
| Unmount Disk |
Related functions
| TrFile_DiskInfo |
| TrFile_MountDisk |
Related topics
Troi File Plug-in online help (overview)
