public static SetInformation GetSetInformation(byte[] buffer, SetInformationLevel informationLevel)
{
switch (informationLevel)
{
case SetInformationLevel.SMB_INFO_STANDARD:
return(new SetInfoStandard(buffer));
case SetInformationLevel.SMB_INFO_SET_EAS:
return(new SetExtendedAttributes(buffer));
case SetInformationLevel.SMB_SET_FILE_BASIC_INFO:
return(new SetFileBasicInfo(buffer));
case SetInformationLevel.SMB_SET_FILE_DISPOSITION_INFO:
return(new SetFileDispositionInfo(buffer));
case SetInformationLevel.SMB_SET_FILE_ALLOCATION_INFO:
return(new SetFileAllocationInfo(buffer));
case SetInformationLevel.SMB_SET_FILE_END_OF_FILE_INFO:
return(new SetFileEndOfFileInfo(buffer));
default:
throw new UnsupportedInformationLevelException();
}
}
public Transaction2SetFileInformationRequest(byte[] parameters, byte[] data, bool isUnicode) : base()
{
FID = LittleEndianConverter.ToUInt16(parameters, 0);
InformationLevel = (SetInformationLevel)LittleEndianConverter.ToUInt16(parameters, 2);
Reserved = LittleEndianConverter.ToUInt16(parameters, 4);
InformationBytes = data;
}
public static SetInformation GetSetInformation(byte[] buffer, SetInformationLevel informationLevel)
{
return(informationLevel switch
{
SetInformationLevel.SMB_SET_FILE_BASIC_INFO => new SetFileBasicInfo(buffer),
SetInformationLevel.SMB_SET_FILE_DISPOSITION_INFO => new SetFileDispositionInfo(buffer),
SetInformationLevel.SMB_SET_FILE_ALLOCATION_INFO => new SetFileAllocationInfo(buffer),
SetInformationLevel.SMB_SET_FILE_END_OF_FILE_INFO => new SetFileEndOfFileInfo(buffer),
_ => throw new UnsupportedInformationLevelException()
});
/// <summary>
/// Create Trans2SetPathInformation request for client to set the path information on server.
/// </summary>
/// <param name = "messageId">the id of message, used to identity the request and the server response. </param>
/// <param name = "sessionUid">the valid session id, must be response by server of the session setup request. </param>
/// <param name = "treeId">the valid tree connect id, must be response by server of the tree connect. </param>
/// <param name = "flags">
/// The Flags field contains individual flags, as specified in [CIFS] sections 2.4.2 and 3.1.1.
/// </param>
/// <param name = "flags2">
/// The Flags2 field contains individual bit flags that, depending on the negotiated SMB dialect, indicate
/// various client and server capabilities.
/// </param>
/// <param name = "fileName">The name of path to set the information on server. </param>
/// <param name = "isUsePathThrough">
/// Indicates that the client is requesting a native Microsoft Windows® NT operating system information level,
/// as specified in section 3.2.4.7 and in [MS-FSCC] section 2.4.
/// </param>
/// <param name = "transactOptions">
/// A set of bit flags that alter the behavior of the requested operation. Unused bit fields MUST be set to
/// zero by the client sending the request, and MUST be ignored by the server receiving the request. The
/// client MAY set either or both of the following bit flags
/// </param>
/// <param name = "timeOut">
/// The maximum amount of time in milliseconds to wait for the operation to complete. The client SHOULD set
/// this to 0 to indicate that no time-out is given. If the operation does not complete within the specified
/// time, the server MAY abort the request and send a failure response.
/// </param>
/// <param name = "informationLevel">
/// Indicates that client specifies the information it is requesting. Server return different data based on
/// the client's request.
/// </param>
/// <param name = "data">the information data to be set. </param>
/// <returns>a set path information request packet </returns>
private SmbTrans2SetPathInformationRequestPacket CreateTrans2SetPathInformationRequest(
ushort messageId,
ushort sessionUid,
ushort treeId,
SmbHeader_Flags_Values flags,
SmbHeader_Flags2_Values flags2,
string fileName,
bool isUsePathThrough,
Trans2SmbParametersFlags transactOptions,
uint timeOut,
SetInformationLevel informationLevel,
byte[] data)
{
if (isUsePathThrough)
{
informationLevel = (SetInformationLevel)
(informationLevel + SmbCapability.CONST_SMB_INFO_PASSTHROUGH);
}
SmbTrans2SetPathInformationRequestPacket packet = new SmbTrans2SetPathInformationRequestPacket(
this.cifsClient.CreateTrans2SetPathInformationRequest(
messageId, sessionUid, treeId, (SmbFlags)flags, (SmbFlags2)flags2,
this.capability.MaxParameterCount, this.capability.MaxDataCount, this.capability.MaxSetupCount,
transactOptions, timeOut, informationLevel, fileName, data));
packet.UpdateCountAndOffset();
return packet;
}
/// <summary>
/// Create Trans2SetPathInformation request for client to set the path information on server.
/// </summary>
/// <param name = "treeId">the valid tree connect id, must be response by server of the tree connect. </param>
/// <param name = "fileName">The name of path to set the information on server. </param>
/// <param name = "transactOptions">
/// A set of bit flags that alter the behavior of the requested operation. Unused bit fields MUST be set to
/// zero by the client sending the request, and MUST be ignored by the server receiving the request. The
/// client MAY set either or both of the following bit flags
/// </param>
/// <param name = "informationLevel">
/// Indicates that client specifies the information it is requesting. Server return different data based on
/// the client's request.
/// </param>
/// <param name = "isReparsePath">If true, the path in the request MUST contain an @GMT token. </param>
/// <param name = "data">the information data to be set. </param>
/// <returns>a set path information request packet </returns>
public virtual SmbTrans2SetPathInformationRequestPacket CreateTrans2SetPathInformationRequest(
ushort treeId,
string fileName,
Trans2SmbParametersFlags transactOptions,
SetInformationLevel informationLevel,
bool isReparsePath,
byte[] data)
{
SmbHeader_Flags2_Values flags2 = this.capability.Flags2;
// update flags2 of header
if (isReparsePath)
{
flags2 |= SmbHeader_Flags2_Values.SMB_FLAGS2_REPARSE_PATH;
}
return CreateTrans2SetPathInformationRequest(
this.MessageId, this.GetSessionIdByTreeId(treeId), treeId, this.capability.Flag,
flags2, fileName, this.capability.IsUsePathThrough, transactOptions, this.capability.Timeout, informationLevel, data);
}
/// <summary>
/// Create Trans2SetFileInformation request for client to set the file information on server.
/// </summary>
/// <param name = "fileId">the valid file id to operation on, response by server. </param>
/// <param name = "transactOptions">
/// A set of bit flags that alter the behavior of the requested operation. Unused bit fields MUST be set to
/// zero by the client sending the request, and MUST be ignored by the server receiving the request. The
/// client MAY set either or both of the following bit flags
/// </param>
/// <param name = "informationLevel">
/// Indicates that client specifies the information it is requesting. Server return different data based on
/// the client's request.
/// </param>
/// <param name = "data">the information data to be set. </param>
/// <returns>a set file information request packet </returns>
public virtual SmbTrans2SetFileInformationRequestPacket CreateTrans2SetFileInformationRequest(
ushort fileId,
Trans2SmbParametersFlags transactOptions,
SetInformationLevel informationLevel,
byte[] data)
{
return CreateTrans2SetFileInformationRequest(
this.MessageId,
this.GetSessionIdByFileId(fileId), this.GetTreeIdByFileId(fileId), this.capability.Flag,
this.capability.Flags2, fileId, transactOptions, this.capability.Timeout,
this.capability.IsUsePathThrough, informationLevel, data);
}
/// <summary>
/// to create a Trans2SetPathInformation request packet.
/// </summary>
/// <param name="uid">This field SHOULD identify the authenticated instance of the user.</param>
/// <param name="treeId">This field identifies the subdirectory (or tree) on the server that the client is
/// accessing.</param>
/// <param name="informationLevel">This field contains an information level code, which determines the
/// information contained in the response.</param>
/// <param name="name">A buffer containing the name of the file to be opened, created, or truncated. The
/// string MUST be null terminated</param>
/// <param name="data">the information data to be set.</param>
/// <returns>a Trans2SetPathInformation request packet</returns>
/// <exception cref="System.NullReferenceException">There is no connection in context. </exception>
public SmbTrans2SetPathInformationRequestPacket CreateTrans2SetPathInformationRequest(
ushort uid,
ushort treeId,
SetInformationLevel informationLevel,
string name,
Object data)
{
return this.CreateTrans2SetPathInformationRequest(this.Context.GetMessageId(this.connectionId),
uid, treeId, this.defaultParameters.Flag, this.defaultParameters.Flag2, this.defaultParameters.MaxParameterCount,
this.defaultParameters.MaxDataCount, this.defaultParameters.MaxSetupCount, this.defaultParameters.Trans2SmbParametersFlags,
this.defaultParameters.Timeout, informationLevel, name, data);
}
/// <summary>
/// to create a Trans2SetPathInformation request packet.
/// </summary>
/// <param name="messageId">This field SHOULD be the multiplex ID that is used to associate a response with a
/// request.</param>
/// <param name="uid">This field SHOULD identify the authenticated instance of the user.</param>
/// <param name="treeId">This field identifies the subdirectory (or tree) on the server that the client is
/// accessing.</param>
/// <param name="flags">An 8-bit field of 1-bit flags describing various features in effect for the
/// message</param>
/// <param name="flags2">A 16-bit field of 1-bit flags that represent various features in effect for the
/// message. Unspecified bits are reserved and MUST be zero.</param>
/// <param name="maxParameterCount">The maximum number of parameter bytes that the client will accept in the
/// transaction reply. The server MUST NOT return more than this number of parameter bytes.</param>
/// <param name="maxDataCount">The maximum number of data bytes that the client will accept in the transaction
/// reply. The server MUST NOT return more than this number of data bytes.</param>
/// <param name="maxSetupCount">Maximum number of setup bytes that the client will accept in the transaction
/// reply. The server MUST NOT return more than this number of setup bytes</param>
/// <param name="smbParametersFlags">A set of bit flags that alter the behavior of the requested operation.
/// Unused bit fields MUST be set to zero by the client sending the request, and MUST be ignored by the server
/// receiving the request. The client MAY set either or both of the following bit flags</param>
/// <param name="timeout">The number of milliseconds the server SHOULD wait for completion of the transaction
/// before generating a timeout. A value of zero indicates that the operation MUST NOT block.</param>
/// <param name="informationLevel">This field contains an information level code, which determines the
/// information contained in the response.</param>
/// <param name="name">A buffer containing the name of the file to be opened, created, or truncated. The
/// string MUST be null terminated</param>
/// <param name="data">the information data to be set.</param>
/// <returns>a Trans2SetPathInformation request packet</returns>
public SmbTrans2SetPathInformationRequestPacket CreateTrans2SetPathInformationRequest(
ushort messageId,
ushort uid,
ushort treeId,
SmbFlags flags,
SmbFlags2 flags2,
ushort maxParameterCount,
ushort maxDataCount,
byte maxSetupCount,
Trans2SmbParametersFlags smbParametersFlags,
uint timeout,
SetInformationLevel informationLevel,
string name,
Object data)
{
if (name == null)
{
name = string.Empty;
}
SmbTrans2SetPathInformationRequestPacket packet = new SmbTrans2SetPathInformationRequestPacket();
packet.SmbHeader = CifsMessageUtils.CreateSmbHeader(SmbCommand.SMB_COM_TRANSACTION2,
messageId, uid, treeId, flags, flags2);
// Set Smb_Parameters
SMB_COM_TRANSACTION2_Request_SMB_Parameters smbParameters =
new SMB_COM_TRANSACTION2_Request_SMB_Parameters();
smbParameters.MaxParameterCount = maxParameterCount;
smbParameters.MaxDataCount = maxDataCount;
smbParameters.MaxSetupCount = maxSetupCount;
smbParameters.Flags = (ushort)smbParametersFlags;
smbParameters.Timeout = timeout;
smbParameters.SetupCount = 1; // the correct count in word of the Setup is always 1.
smbParameters.Setup = new ushort[] { (ushort)Trans2SubCommand.TRANS2_SET_PATH_INFORMATION };
smbParameters.WordCount = (byte)(CifsMessageUtils.GetSize<SMB_COM_TRANSACTION2_Request_SMB_Parameters>(
smbParameters) / NumBytesOfWord);
// Set Smb_Data
SMB_COM_TRANSACTION2_Request_SMB_Data smbData = new SMB_COM_TRANSACTION2_Request_SMB_Data();
smbData.Name = CifsMessageUtils.ToSmbStringBytes(name,
(flags2 & SmbFlags2.SMB_FLAGS2_UNICODE) == SmbFlags2.SMB_FLAGS2_UNICODE);
// Set Trans2_Parameters
TRANS2_SET_PATH_INFORMATION_Request_Trans2_Parameters trans2Parameters =
new TRANS2_SET_PATH_INFORMATION_Request_Trans2_Parameters();
trans2Parameters.InformationLevel = informationLevel;
trans2Parameters.FileName = CifsMessageUtils.ToSmbStringBytes(name,
(flags2 & SmbFlags2.SMB_FLAGS2_UNICODE) == SmbFlags2.SMB_FLAGS2_UNICODE);
// The size of the preceding SmbParameters part plus Header part is an odd number for all cifs messages
// Use Name field to judge whether needs to add one 16-bits align pad.
if ((flags2 & SmbFlags2.SMB_FLAGS2_UNICODE) == SmbFlags2.SMB_FLAGS2_UNICODE && smbData.Name.Length
% twoBytesAlign == 0)
{
// pad 1 byte for 16-bits align:
smbData.Pad1 = new byte[1];
}
else
{
smbData.Pad1 = new byte[0];
}
// Set Trans2_Data
TRANS2_SET_PATH_INFORMATION_Request_Trans2_Data trans2Data =
new TRANS2_SET_PATH_INFORMATION_Request_Trans2_Data();
if (data != null)
{
if (data.GetType() == typeof(SMB_INFO_SET_EAS))
{
SMB_INFO_SET_EAS info = (SMB_INFO_SET_EAS)data;
if (info.ExtendedAttributeList == null)
{
info.ExtendedAttributeList = new SMB_FEA[0];
}
info.SizeOfListInBytes = (uint)CifsMessageUtils.GetSize<uint>(info.SizeOfListInBytes);
info.SizeOfListInBytes += CifsMessageUtils.GetSmbEAListSize(info.ExtendedAttributeList);
data = info;
}
else if (data.GetType() == typeof(SMB_INFO_STANDARD_OF_TRANS2_SET_PATH_INFORMATION))
{
SMB_INFO_STANDARD_OF_TRANS2_SET_PATH_INFORMATION info =
(SMB_INFO_STANDARD_OF_TRANS2_SET_PATH_INFORMATION)data;
{
// Reserved (10 bytes): MUST be set to zero when sent and MUST be ignored on receipt.
info.Reserved = new byte[10];
data = info;
}
}
else
{
// Nothing needs to do.
}
}
trans2Data.Data = data;
packet.SmbParameters = smbParameters;
packet.SmbData = smbData;
packet.Trans2Parameters = trans2Parameters;
packet.Trans2Data = trans2Data;
packet.UpdateCountAndOffset();
return packet;
}
public Transaction2SetPathInformationRequest(byte[] parameters, byte[] data, bool isUnicode) : base()
{
InformationLevel = (SetInformationLevel)LittleEndianConverter.ToUInt16(parameters, 0);
Reserved = LittleEndianConverter.ToUInt32(parameters, 2);
FileName = SMBHelper.ReadSMBString(parameters, 6, isUnicode);
}