/// <summary>
/// to create a Search 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="maxCount">The maximum number of directory entries to return</param>
/// <param name="searchAttributes">ATTRIBUTES An attribute mask used to specify the standard attributes a file
/// MUST have in order to match the search</param>
/// <param name="fileName">null-terminated SMB_STRING. This is the full directory path (relative to the TID) of
/// the file(s) being sought</param>
/// <param name="resumeKey">The ResumeKey contains data used by both the client and the server to maintain the
/// state of the search</param>
/// <returns>a Search request packet</returns>
/// <exception cref="System.NullReferenceException">There is no connection in context. </exception>
public SmbSearchRequestPacket CreateSearchRequest(
ushort uid,
ushort treeId,
ushort maxCount,
SmbFileAttributes searchAttributes,
string fileName,
SMB_Resume_Key[] resumeKey)
{
return this.CreateSearchRequest(this.Context.GetMessageId(this.connectionId),
uid, treeId, this.defaultParameters.Flag, this.defaultParameters.Flag2, maxCount,
searchAttributes, fileName, resumeKey);
}
/// <summary>
/// to create a FindClose 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="resumeKey">This MUST be the last ResumeKey returned by the server in the search being
/// closed.</param>
/// <returns>a FindClose request packet</returns>
/// <exception cref="System.NullReferenceException">There is no connection in context. </exception>
public SmbFindCloseRequestPacket CreateFindCloseRequest(
ushort uid,
ushort treeId,
SMB_Resume_Key resumeKey)
{
return this.CreateFindCloseRequest(this.Context.GetMessageId(this.connectionId),
uid, treeId, this.defaultParameters.Flag, this.defaultParameters.Flag2, string.Empty, resumeKey);
}
/// <summary>
/// to create a Search 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="maxCount">The maximum number of directory entries to return</param>
/// <param name="searchAttributes">ATTRIBUTES An attribute mask used to specify the standard attributes a file
/// MUST have in order to match the search</param>
/// <param name="fileName">null-terminated SMB_STRING. This is the full directory path (relative to the TID) of
/// the file(s) being sought</param>
/// <param name="resumeKey">The ResumeKey contains data used by both the client and the server to maintain the
/// state of the search</param>
/// <returns>a Search request packet</returns>
public SmbSearchRequestPacket CreateSearchRequest(
ushort messageId,
ushort uid,
ushort treeId,
SmbFlags flags,
SmbFlags2 flags2,
ushort maxCount,
SmbFileAttributes searchAttributes,
string fileName,
SMB_Resume_Key[] resumeKey)
{
if (fileName == null)
{
fileName = string.Empty;
}
if (resumeKey == null)
{
resumeKey = new SMB_Resume_Key[0];
}
SmbSearchRequestPacket packet = new SmbSearchRequestPacket();
packet.SmbHeader = CifsMessageUtils.CreateSmbHeader(SmbCommand.SMB_COM_SEARCH,
messageId, uid, treeId, flags, flags2);
SMB_COM_SEARCH_Request_SMB_Parameters smbParameters = new SMB_COM_SEARCH_Request_SMB_Parameters();
smbParameters.MaxCount = maxCount;
smbParameters.SearchAttributes = searchAttributes;
smbParameters.WordCount = (byte)(Marshal.SizeOf(smbParameters) / NumBytesOfWord);
SMB_COM_SEARCH_Request_SMB_Data smbData = new SMB_COM_SEARCH_Request_SMB_Data();
int resumeKeySize = 0;
if (resumeKey.Length > 0)
{
resumeKeySize = CifsMessageUtils.GetSize<SMB_Resume_Key>(resumeKey[0]);
}
smbData.BufferFormat1 = (byte)DataBufferFormat.SmbString;
smbData.BufferFormat2 = (byte)DataBufferFormat.VariableBlock;
smbData.ResumeKey = resumeKey;
smbData.ResumeKeyLength = (ushort)resumeKeySize;
smbData.FileName = CifsMessageUtils.ToSmbStringBytes(fileName,
(flags2 & SmbFlags2.SMB_FLAGS2_UNICODE) == SmbFlags2.SMB_FLAGS2_UNICODE);
smbData.ByteCount = (ushort)(Marshal.SizeOf(smbData.BufferFormat1) + smbData.FileName.Length
+ Marshal.SizeOf(smbData.BufferFormat2) + Marshal.SizeOf(smbData.ResumeKeyLength)
+ smbData.ResumeKeyLength);
packet.SmbParameters = smbParameters;
packet.SmbData = smbData;
return packet;
}
/// <summary>
/// to create a FindClose 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="fileName">A NUL-terminated SMB_STRING. This MUST be the empty string.</param>
/// <param name="resumeKey">This MUST be the last ResumeKey returned by the server in the search being
/// closed.</param>
/// <returns>a FindClose request packet</returns>
public SmbFindCloseRequestPacket CreateFindCloseRequest(
ushort messageId,
ushort uid,
ushort treeId,
SmbFlags flags,
SmbFlags2 flags2,
string fileName,
SMB_Resume_Key resumeKey)
{
if (fileName == null)
{
fileName = string.Empty;
}
SmbFindCloseRequestPacket packet = new SmbFindCloseRequestPacket();
packet.SmbHeader = CifsMessageUtils.CreateSmbHeader(SmbCommand.SMB_COM_FIND_CLOSE,
messageId, uid, treeId, flags, flags2);
SMB_COM_FIND_CLOSE_Request_SMB_Parameters smbParameters = new SMB_COM_FIND_CLOSE_Request_SMB_Parameters();
smbParameters.MaxCount = 0;
smbParameters.SearchAttributes = 0;
smbParameters.WordCount = (byte)(Marshal.SizeOf(smbParameters) / NumBytesOfWord);
SMB_COM_FIND_CLOSE_Request_SMB_Data smbData = new SMB_COM_FIND_CLOSE_Request_SMB_Data();
smbData.BufferFormat1 = (byte)DataBufferFormat.SmbString;
smbData.FileName = CifsMessageUtils.ToSmbStringBytes(fileName,
(flags2 & SmbFlags2.SMB_FLAGS2_UNICODE) == SmbFlags2.SMB_FLAGS2_UNICODE);
smbData.BufferFormat2 = (byte)DataBufferFormat.VariableBlock;
smbData.ResumeKey = resumeKey;
smbData.ResumeKeyLength = (ushort)CifsMessageUtils.GetSize<SMB_Resume_Key>(smbData.ResumeKey);
smbData.ByteCount = (ushort)(Marshal.SizeOf(smbData.BufferFormat1) + Marshal.SizeOf(smbData.BufferFormat2)
+ Marshal.SizeOf(smbData.ResumeKeyLength) + CifsMessageUtils.GetSize<SMB_Resume_Key>(smbData.ResumeKey)
+ smbData.FileName.Length);
packet.SmbParameters = smbParameters;
packet.SmbData = smbData;
return packet;
}
