2.4.5 FileAlternateNameInformation

This information class is used to query alternate name information for a file. The alternate name for a file is its 8.3 format name (eight characters that appear before the "." and three characters that appear after). A file MAY have an alternate name to achieve compatibility with the 8.3 naming requirements of legacy applications.<101>

A FILE_NAME_INFORMATION (section 2.1.7) data element containing an 8.3 file name (section 2.1.5.2.1) is returned by the server.

This operation returns a status code as specified in section 2.2. Upon success, the status code returned by the function that processes this file information class is STATUS_SUCCESS. The most common error codes are listed in the following table.

Error code

Meaning

STATUS_INFO_LENGTH_MISMATCH

0xC0000004

The specified information record length does not match the length that is required for the specified information class.

STATUS_OBJECT_NAME_NOT_FOUND

0xC0000034

The object name is not found or is empty.

STATUS_BUFFER_OVERFLOW

0x80000005

The output buffer was filled before the complete name could be returned.