FSF.ConvertNameToReal

Far Manager

previous page next page

ConvertNameToReal

main | FarStandardFunctions
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

  1. 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.
  2. Parameters Src and Dest can point to the same string.

Example

previous page start next page