get_long_path_name


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.

Parameters

const character* short_path

A pointer to the short name for the file.

character* long_path

A pointer to a buffer to hold the long name of the file.

unsigned buffer

The size of the buffer pointed to by the previous parameter.

Return

unsigned

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.