template <class character> unsigned get_long_path_name(const character* short_path, character* long_path, unsigned buffer)
This function obtains the long name of a file.
const character* short_path
A pointer to the short name for the file.
A pointer to a buffer to hold the long name of the file.
The size of the buffer pointed to by the previous parameter.
If the specified buffer size was adequate, the value returned is the number of characters transferred to the buffer (not including the null). If the specified buffer size was inadequate, the value returned is the buffer size (in characters) required to hold the long path name.
Zero is returned if an error occurs.