/// <summary>
/// Create TransNamedRap request for client to send a rap request to 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 = "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="rapOPCode">
/// The operation code for the particular operation. For more information on valid operation codes, see 2.5.4.
/// </param>
/// <param name="paramDesc">
/// This value MUST be a null-terminated ASCII descriptor string. The server SHOULD validate that the ParamDesc
/// value passed by the client matches what is specified by the RAPOpcode. The following table specifies the
/// descriptor character and the notation for each data type.
/// </param>
/// <param name="dataDesc">
/// (Optional) If this value is specified, it MUST be a null-terminated ASCII descriptor string that describes
/// the contents of the data returned to the client. Certain RAPOpcodes specify a DataDesc field; for a list
/// of Remote Administration Protocol commands that specify a DataDesc field, see section 2.5.5.
/// </param>
/// <param name="rapParamsAndAuxDesc">
/// This field combines the following fields, because each of their length is unknown:<para/>
/// RAPParams: Remote Administration Protocol command-specific parameters, as specified in sections 2.5.5, 2.5.6, 2.5.7,
/// 2.5.8, and 2.5.9.<para/>
/// AuxDesc: (Optional) If this value is specified, it MUST be a null-terminated ASCII descriptor string that describes
/// auxiliary data returned to the client. If no AuxDesc field is specified for the Remote Administration
/// Protocol command, this field MUST NOT be present. For the origin of the descriptor string values, see
/// section 4.2.
/// </param>
/// <param name="rapInData">
/// Additional data for the Remote Administration Protocol request. This field MUST be present in the
/// NetPrintJobSetInfoRequest command. This field cannot be present in any other command.
/// </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>
/// <returns>a named rap request packet </returns>
private SmbTransRapRequestPacket CreateTransNamedRapRequest(
ushort messageId,
ushort sessionUid,
ushort treeId,
SmbHeader_Flags_Values flags,
SmbHeader_Flags2_Values flags2,
TransSmbParametersFlags transactOptions,
ushort rapOPCode,
byte[] paramDesc,
byte[] dataDesc,
byte[] rapParamsAndAuxDesc,
byte[] rapInData,
uint timeOut)
{
SmbTransRapRequestPacket packet = new SmbTransRapRequestPacket();
packet.SmbHeader = CifsMessageUtils.CreateSmbHeader(SmbCommand.SMB_COM_TRANSACTION,
messageId, sessionUid, treeId, (SmbFlags)flags, (SmbFlags2)flags2);
// Set Smb Parameters
SMB_COM_TRANSACTION_Request_SMB_Parameters smbParameters =
new SMB_COM_TRANSACTION_Request_SMB_Parameters();
smbParameters.MaxParameterCount = this.capability.MaxParameterCount;
smbParameters.MaxDataCount = this.capability.MaxDataCount;
smbParameters.MaxSetupCount = this.capability.MaxSetupCount;
smbParameters.Flags = transactOptions;
smbParameters.Timeout = timeOut;
smbParameters.SetupCount = 0; // the correct count in word of the Setup is always 0.
smbParameters.Setup = new ushort[0];
smbParameters.WordCount = (byte)(CifsMessageUtils.GetSize<SMB_COM_TRANSACTION_Request_SMB_Parameters>(
smbParameters) / SmbCapability.NUM_BYTES_OF_WORD);
// Set Smb Data
SMB_COM_TRANSACTION_Request_SMB_Data smbData = new SMB_COM_TRANSACTION_Request_SMB_Data();
smbData.Name = CifsMessageUtils.ToSmbStringBytes("", this.capability.IsUnicode);
// Set Transaction Parameters
TRANSACTION_Rap_Request_Trans_Parameters transParameters = new TRANSACTION_Rap_Request_Trans_Parameters();
transParameters.RapOPCode = rapOPCode;
transParameters.ParamDesc = paramDesc;
transParameters.DataDesc = dataDesc;
transParameters.RAPParamsAndAuxDesc = rapParamsAndAuxDesc;
// Set Transaction Data
TRANSACTION_Rap_Request_Trans_Data transData = new TRANSACTION_Rap_Request_Trans_Data();
transData.RAPInData = rapInData;
packet.SmbParameters = smbParameters;
packet.SmbData = smbData;
packet.TransParameters = transParameters;
packet.TransData = transData;
packet.UpdateCountAndOffset();
// update TransactionSubCommand in SmbGlobalContext, record the transact action
this.capability.TransactionSubCommand = TransSubCommandExtended.TRANS_EXT_RAP;
return packet;
}
/// <summary>
/// to decode the Trans parameters: from the general TransParameters to the concrete Trans Parameters.
/// </summary>
protected override void DecodeTransParameters()
{
if (this.smbData.Trans_Parameters == null || this.smbData.Trans_Parameters.Length == 0)
{
return;
}
TRANSACTION_Rap_Request_Trans_Parameters param = new TRANSACTION_Rap_Request_Trans_Parameters();
using (MemoryStream stream = new MemoryStream(this.smbData.Trans_Parameters))
{
using (Channel channel = new Channel(null, stream))
{
param.RapOPCode = channel.Read<ushort>();
// the ParamDesc and DataDesc size
int descSize = this.smbData.Trans_Parameters.Length - SmbCapability.NUM_BYTES_OF_WORD;
if (descSize > 0)
{
byte[] descs = channel.ReadBytes(descSize);
int start = 0;
int index = 0;
// read the field ParamDesc.
if ((index = FindEndIndexOfAsciiString(descs, start)) != -1)
{
// move to the terminated descriptor.
index++;
// get the data
param.ParamDesc = ArrayUtility.SubArray<byte>(descs, start, index - start);
// update the start
start = index ;
}
// read the field DataDesc.
if ((index = FindEndIndexOfAsciiString(descs, start)) != -1)
{
// move to the terminated descriptor.
index++;
// get the data
param.DataDesc = ArrayUtility.SubArray<byte>(descs, start, index - start);
// update the start
start = index ;
}
// read the field RAPParamsAndAuxDesc.
if (descSize > start)
{
param.RAPParamsAndAuxDesc = ArrayUtility.SubArray<byte>(descs, start, descSize - start);
}
}
}
}
this.transParameters = param;
}