2.4.41 FileRenameInformation
This information class is used to rename a file. The data element provided by the client takes one of two forms, depending on whether it is embedded within SMB or SMB2. The structure definitions are as follows:
FILE_RENAME_INFORMATION_TYPE_1 for the SMB protocol (section 2.4.41.1).
FILE_RENAME_INFORMATION_TYPE_2 for the SMB2 protocol (section 2.4.41.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 passed for FileName or FileNameLength, or the RootDirectory field value was nonzero for a network operation. |
|
STATUS_ACCESS_DENIED 0xC0000022 |
The handle was not opened with delete access, or the target file was open and ReplaceIfExists is nonzero. |
|
STATUS_NOT_SAME_DEVICE 0xC00000D4 |
The destination file of a rename request is located on a different device than the source of the rename request. |
|
STATUS_OBJECT_NAME_INVALID 0xC0000033 |
The object name is invalid for the target file system. |
|
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. |