FSF.GetReparsePointInfo

Far Manager

GetReparsePointInfo

The FSF.GetReparsePointInfo function allows to determine the target (path to the target drive and directory) of a symbolic link (reparse point).
int WINAPI GetReparsePointInfo(
  const char *Src,
  char *Dest,
  int DestSize
);

Parameters

Src
Source string. Must contain a full pathname to a symbolic link terminated with a backslash ('\').
Dest
Destination string. May be NULL.
DestSize
Length of the destination string (Dest). If Dest=NULL, DestSize is ignored.

Return value

The actual size of the string stored in Dest, or the required buffer size if Dest is NULL.

The function returns 0 in case of an error:

  • the function is not supported (the current operating system is not Windows 2000 or later);
  • if the path is invalid (in this case, the system error code ERROR_PATH_NOT_FOUND is set).
  • symbolic link is on a network drive and in most cases real directory name where symbolic link points to is useless.

Remarks

  1. Src and Dest can point to the same string.
  2. The function works only under Windows 2000 or later.
  3. Return value is practically useless for symbolic links on network drives.
  4. Unlike ConvertNameToReal, this function can only be used for symbolic links.
  5. You can obtain a bit of information about symbolic links here.

Example