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
- Src and Dest can point to the same string.
- The function works only under Windows 2000 or later.
- Return value is practically useless for symbolic links on network drives.
- Unlike ConvertNameToReal, this function can only be used for symbolic links.
- You can obtain a bit of information about symbolic links here.