xcall MIAMEX, MX_MKPATH, dirspec, status
MX_MKPATH (MIAMEX 38) creates a new native operating system directory. MX_MKPATH may (and should) be called for any operating system.
Parameters
Parameter |
Type |
I/O |
Description |
---|---|---|---|
dirspec |
in |
the directory name to create. This should be in native file format, but (as of build 960) may include embedded environment variables (e.g. %miame%\newdir). |
|
status |
out |
will return 0 for success, else an error number. |
Comments
MX_MKDIR will be invoked automatically if this function is requested under Windows. Therefore, it may be best to always use MX_MKPATH in your application and let A-Shell decide when to convert it to MX_MKDIR. The exception would be if your application which is running on a server (with ATE clients) wants to explicitly create a directory on the ATE client. In this case, you must use MX_MKDIR and set the remoteflag parameter to "R."
Note that this function supports embedded environment variables, e.g.:
xcall MIAMEX,MX_MKPATH,"%MIAME%\901902",STATUS
In general this function will not succeed if the parent directory doesn't already exist.
See Also