This function is used to canonize a file name, i.e. get the full file name (e.g. d:\files\temp\test.txt) from a '..\temp\test.txt'-type relative name.
Context
Windows client,
Windows server,
Java client,
Java server,
Adelia Web client,
Adelia Cloud client.
Parameters
ALPHA(n) |
FileName |
Name of file to be canonized. |
ALPHA(n) |
FullName |
Variable receiving the full file name if successful. |
NUM_BIN_4 |
FullNameLg |
Length of the FullName variable. |
BOOL |
ReturnCode |
*TRUE if the operation has been performed successfully. Output parameter. |
Note:
As Windows CE does not have the notion of current directory, it does not provide the notion of relative path or the related support functions. This function is therefore not available on Mobile platform. You should always use full file names.
Example
ALPHA(256) FileName
ALPHA(256) FullName
NUM_BIN_4 FullNameLg
BOOL ReturnCode
* Creates a temporary file in the temporary directory
FullNameLg = 256
CALL_DLL 'VATOOLBX.DLL' 'VaToolBxGetFullPathName' FileName FullName FullNameLg ReturnCode
IF NOT ReturnCode
* Error processing...
END
List of functions in the VaToolBx DLL by topic