2.4.27 FileLinkInformation

This information class is used to create a hard link to an existing file.<132> The Server Message Block (SMB) Protocol [MS-SMB] and the Server Message Block (SMB) Version 2 Protocol [MS-SMB2] implement unique structure variants:

  • FILE_LINK_INFORMATION_TYPE_1, as specified in section 2.4.27.1.

  • FILE_LINK_INFORMATION_TYPE_2, as specified in section 2.4.27.2.

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_PARAMETER

0xC000000D

An invalid parameter was specified for the RootDirectory field.

STATUS_FILE_IS_A_DIRECTORY

0xC00000BA

The file that was specified is a directory.

STATUS_ACCESS_DENIED

0xC0000022

The object has been deleted.

STATUS_OBJECT_NAME_INVALID

0xC0000033

The object name is invalid for the target file system.

STATUS_TOO_MANY_LINKS

0xC0000265

An attempt was made to create more links on a file than the file system supports.

STATUS_OBJECT_NAME_COLLISION

0xC0000035

The specified name already exists and ReplaceIfExists is zero.

STATUS_INFO_LENGTH_MISMATCH

0xC0000004

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

STATUS_NOT_SUPPORTED

0xC00000BB

The request is not supported.