ConvertNameToReal
The FSF.ConvertNameToReal function converts a relative name of a file
object to its full pathname and expands symbolic links (Windows 2000 reparse points).
int WINAPI ConvertNameToReal( const char *Src, char *Dest, int DestSize );
Parameters
Src
Source string - a full or relative name of a file or a directory.
Dest
Destination string - the expanded pathname will be
stored here. Can be
NULL.
DestSize
Length of the destination string. If Dest=
NULL,
DestSize is ignored.
Return value
The actual size needed to store the expanded pathname in Dest.
- For mounted drives that do not have a drive letter assigned, the function will
store into Dest a string similar to this one:
"\\?\Volume{273872e0-5e49-11d5-b614-0080ad70bb9b}\Foo.bar" - If, for example, the directory "D:\Foo\Bar" is a symbolic link to an
existing directory "C:\work\doc", calling this function for the file
"D:\Foo\Bar\1092\readme.txt"will return"C:\work\Doc\1092\readme.txt".
Remarks
- The function correctly determines the real pathname only under Windows 2000 or later. Under earlier operating systems, it is not possible to determine the real name of a symbolic link if one is encountered in the path.
- Parameters Src and Dest can point to the same string.