2.4.31 FileObjectIdInformation

This information class is used locally to query object ID information for the files in a directory on a volume. The query MUST fail if the file system does not support object IDs.<126>

The data returned to the caller will take one of two forms. The choice of which data structure to use, and the interpretation of the data within it, is application-specific. An application implementer chooses one of the following two data elements as the structure for its object ID information data.<127>

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_INVALID_DEVICE_REQUEST

0xC0000010

The target file system does not implement this functionality.

STATUS_INVALID_INFO_CLASS

0xC0000003

The specified information class is not a valid information class for the specified object.

STATUS_INFO_LENGTH_MISMATCH

0xC0000004

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

STATUS_INVALID_PARAMETER

0xC000000D

The file specified is not a valid parameter.

STATUS_NO_SUCH_FILE

0xC000000F

The file does not exist.

STATUS_NO_MORE_FILES

0x80000006

No more files were found which match the file specification.

STATUS_BUFFER_OVERFLOW

0x80000005

The output buffer was filled before all of the ObjectID information could be returned. Only complete FILE_OBJECTID_INFORMATION structures are returned.