TElMessageEncryptor.Encrypt method

Navigation

TElMessageEncryptor.Encrypt

Encrypts the block of data

Declaration

[C#]
    int Encrypt(byte[] InBuffer, ref byte[] OutBuffer, ref int OutSize);
    int Encrypt(byte[] InBuffer, ref byte[] OutBuffer, ref int OutSize, byte[] Key);
    int Encrypt(byte[] InBuffer, int InStartIndex, int InSize, byte[] OutBuffer, int OutStartIndex, ref int OutSize);
    int Encrypt(byte[] InBuffer, int InStartIndex, int InSize, byte[] OutBuffer, int OutStartIndex, ref int OutSize, byte[] Key);
    int Encrypt(System.IO.Stream InStream, System.IO.Stream OutStream, long InCount /* = 0 */);
    int Encrypt(System.IO.Stream InStream, System.IO.Stream OutStream, byte[] Key, long InCount /* = 0 */);

[VB.NET]
    Function Encrypt(ByVal InBuffer As Byte(), ByRef OutBuffer As Byte(), ByRef OutSize As Integer) As Integer
    Function Encrypt(ByVal InBuffer As Byte(), ByRef OutBuffer As Byte(), ByRef OutSize As Integer, ByVal Key As Byte()) As Integer
    Function Encrypt(ByVal InBuffer As Byte(), ByVal InStartIndex As Integer, ByVal InSize As Integer, ByVal OutBuffer As Byte(), ByVal OutStartIndex As Integer, ByRef OutSize As Integer) As Integer
    Function Encrypt(ByVal InBuffer As Byte(), ByVal InStartIndex As Integer, ByVal InSize As Integer, ByVal OutBuffer As Byte(), ByVal OutStartIndex As Integer, ByRef OutSize As Integer, ByVal Key As Byte()) As Integer
    Function Encrypt(ByVal InStream As System.IO.Stream, ByVal OutStream As System.IO.Stream, ByVal InCount As Long = 0) As Integer
    Function Encrypt(ByVal InStream As System.IO.Stream, ByVal OutStream As System.IO.Stream, ByVal Key As Byte(), ByVal InCount As Long = 0) As Integer

[Pascal]
    function Encrypt(InBuffer : pointer; InSize : integer; OutBuffer : pointer; var OutSize : integer) : integer; overload;
    function Encrypt(InBuffer : pointer; InSize : integer; OutBuffer : pointer; var OutSize : integer; Key : pointer; KeySize : integer) : integer; overload;
    function Encrypt(InStream, OutStream : TStream; InCount : Int64) : integer; overload;
    function Encrypt(InStream, OutStream : TStream; Key : pointer; KeySize : integer) : integer; overload;

[VB6]
Sub IElMessageEncryptorX.Encrypt(InBuffer As Byte(), OutBuffer As Byte())

[ActiveX]
HRESULT _stdcall IElMessageEncryptorX.Encrypt([in] VARIANT InBuffer, [out] VARIANT * OutBuffer );

[DLL]
__stdcall int SBMessageEncryptorEncrypt(HANDLE hEncryptor, void* pInBuffer, int nInSize, void* pOutBuffer, int* nOutSize);

Parameters

[DLL]hEncryptor - handle to the TElMessageEncryptor object that was returned by Constructor

InBuffer (pInBuffer) - Reference to the data to encrypt.

InStartIndex - Starting index of the data to be encrypted in the InBuffer.

InSize (nInSize) - Size of the input data in bytes.

OutBuffer (pOutBuffer) - Reference to the buffer where encrypted data should be stored.

OutStartIndex - Starting index of the encrypted data in the OutBuffer.

OutSize (nOutSize) - Size of the OutBuffer in bytes.

InStream - Stream to be encrypted.

OutStream - Resulting encrypted stream.

Key - Symmetric key for data encryption.

KeySize - Size of the Key.

InCount - Number of bytes to be read from InStream. If this parameter is 0 the data is read till the end of the stream.
Default value is 0.

Return value

0 if the encryption process was completed successfully.
one of the following error codes otherwise,

[C#] [Pascal] [ActiveX] [DLL] Value Description

SB_MESSAGE_ERROR_NO_ENCRYPTED_DATA 8193 (0x2001) Message doesn't contain encrypted data

SB_MESSAGE_ERROR_NO_CERTIFICATE 8194 (0x2002)
Decryption/Signature verification: Certificate which was used to encrypt/sign message was not found.
Encryption/Signing: Certificate storage is empty.
Signing: Certificate storage doesn't contain any certificate with corresponding private key.
Decryption: The required certificate is found but it doesn't contain the corresponding private key.

SB_MESSAGE_ERROR_KEY_DECRYPTION_FAILED 8195 (0x2003) TElMessageDecryptor was unable to decrypt the content encryption key. The high possibility that message is corrupted.

SB_MESSAGE_ERROR_BUFFER_TOO_SMALL 8196 (0x2004) The buffer for output data is too small. Check the OutSize property to obtain the required buffer size.

SB_MESSAGE_ERROR_CONTENT_DECRYPTION_FAILED 8197 (0x2005) TElMessageDecryptor was unable to decrypt the content. The high possibility that message is corrupted.

SB_MESSAGE_ERROR_INVALID_FORMAT 8198 (0x2006) The message passed to Decrypt/Verify routine is not valid PKCS7 message.

SB_MESSAGE_ERROR_NO_RECIPIENTS 8199 (0x2007) CertStorage is empty or contains invalid certificates.

SB_MESSAGE_ERROR_UNSUPPORTED_ALGORITHM 8200 (0x2008)
TElMessageDecryptor/ElMessageVerifier: The incoming message contains data encrypted using unsupported algorithm
TElMessageEncryptor/ElMessageSigner: Algorithm or DigestAlgorithm property is set to invalid value

SB_MESSAGE_ERROR_ENCRYPTION_FAILED 8201 (0x2009) TElMessageEncryptor was unable to encrypt message due to internal error

SB_MESSAGE_ERROR_INVALID_KEY_LENGTH 8202 (0x200A) Property BitsInKey is set to invalid value.

SB_MESSAGE_ERROR_NO_SIGNED_DATA 8203 (0x200B) No signed data was found.

SB_MESSAGE_ERROR_INVALID_SIGNATURE 8204 (0x200C) Signed message contains invalid digital signature. The high possibility that signature was corrupted.

SB_MESSAGE_ERROR_INVALID_DIGEST 8205 (0x200D) Signed message contains invalid message digest. The high possibility that original message was tampered.

SB_MESSAGE_ERROR_SIGNING_FAILED 8206 (0x200E) TElMessageSigner was unable to sign message due to internal error

SB_MESSAGE_ERROR_INTERNAL_ERROR 8207 (0x200F) Internal error occured. Please contact EldoS support.

SB_MESSAGE_ERROR_INVALID_MAC 8208 (0x2010) Signed message contains invalid MAC signature. The high possibility that signature was tampered.

SB_MESSAGE_ERROR_UNSUPPORTED_SIGNATURE_TYPE 8209 (0x2011) Message signature is of an unsupported type.

SB_MESSAGE_ERROR_INVALID_COUNTERSIGNATURE 8210 (0x2012) The countersignature is not valid.

SB_MESSAGE_ERROR_DIGEST_NOT_FOUND 8211 (0x2013) Cannot obtain message digest.

SB_MESSAGE_ERROR_UNSUPPORTED_DIGEST_ALGORITHM 8212 (0x2014) Digest value is computed via an unsupported digest algorithm

SB_MESSAGE_ERROR_CANCELLED_BY_USER 8213 (0x2015) The action is cancelled by user.

SB_MESSAGE_ERROR_VERIFICATION_FAILED 8214 (0x2016) This error is reported if any exception is rised during message verification.

SB_MESSAGE_ERROR_DIGEST_CALCULATION_FAILED 8215 (0x2017) This error is reported if any exception is rised during digest calculation.

SB_MESSAGE_ERROR_MAC_CALCULATION_FAILED 8216 (0x2018) This error is reported, when MAC calculation is failed.

SB_MESSAGE_ERROR_TSPCLIENT_NOT_FOUND 8217 (0x2019) This error is reported, when there is no object associated with TSP client

SB_MESSAGE_ERROR_BAD_TIMESTAMP 8218 (0x201A) This error is reported, if message time stamp does not succeed verification

SB_MESSAGE_ERROR_KEYOP_FAILED_RSA 8219 (0x201B) This error is reported, when operation with RSA key has failed

SB_MESSAGE_ERROR_KEYOP_FAILED_DSA 8220 (0x201C) This error is reported, when operation with DSA key has failed

SB_MESSAGE_ERROR_KEYOP_FAILED_RSA_PSS 8221 (0x201D) This error is reported, when operation with RSA PSS key has failed

Declared in

[.NET] [Pascal]

Namespace: SBMessages
Assembly: SecureBlackbox Unit: SBMessages

Description

Use this method to encrypt blocks of data. Block of data is encrypted using each certificate from CertStorage and may be decrypted with any of that certificates. After the method is executed, OutSize parameter contains the number of bytes, written to the OutBuffer. If the buffer was too small, then the necessary size is put to OutSize.