DEScipher and TDEScipher/ActiveX Properties, Methods and Error Codes

Properties, Methods and Error Codes for DEScipher and TDEScipher
DEScipher/ActiveX	TDEScipher/ActiveX

TDEScipher/ActiveX Property Box
property_tdes.gif (6110 bytes)

DEScipher/ActiveX Property Box

TDES- and DEScipher/ActiveX Special Properties
Properties Descriptions

BlockSize Property BlockSize determines the size of each DES input block. This is the number of input bits (not bytes) processed in each pass through the DES algorithm.

CipherKey Property The CipherKey Property defines the cipher key used for encryption/decryption of the data stream. A valid cipher key is comprised of 64 bits (8 bytes) of data. Every eighth bit is used as a parity bit (see CheckKeyParity Property) and, therefore, is not actually used in the encryption process.

CipherKey2 Property (TDEScipher only) For Triple-DES modes of operation the CipherKey2 Property defines the key value used in the second round of encryption/decryption. The composition of the CipherKey2 data is the same as CipherKey.

CipherKey3 Property (TDEScipher only) For Triple-DES modes of operation the CipherKey2 Property defines the key value used in the second round of encryption/decryption. The composition of the CipherKey2 data is the same as CipherKey.

DESMode Property The DESMode Property defines the DES encryption method that will be used. There are four modes of DES encryption, and eight modes of TDES:

TDES- and DEScipher Modes TDEScipher-only Modes

Electronic Codebook Triple Electronic Codebook

Cipher Block Chaining Triple Cipher Block Chaining

Cipher Feedback Triple Cipher Feedback

Output Feedback Triple Output Feedback

InitVector Property The InitVector Property defines the initialization vector used in Cipher Block Chaining (CBC), Cipher Feedback (CFB) and Output Feedback (OFB) modes of DES, and the Triple Cipher Block Chaining (TCBC), Triple Cipher Feedback (TCFB) and Triple Output Feedback (TOFB) modes of TDEA. The Electronic Codebook (ECB) and Triple Electronic Codebook modes of DES/TDEA do not use the InitVector Property.

CheckKeyParity Property The CheckKeyParity Property determines whether or not the parity of the cipher key is checked for odd parity. This property is not important if your application does not require keys that have odd parity.

RandomKey Property The RandomKey Property will generate a random cipher key each time it is accessed. The generated cipher key is guaranteed not to be a "weak key".

Unicode Property The Unicode Property is used to enable/disable Unicode processing of Basic Strings (BSTR data types). The default state of the Unicode Property is True. (NOTE: Unicode is an international character-encoding standard using 16-bit character values to represent all the characters used in modern computing.)

TDES- and DEScipher/ActiveX Methods
Method Description

DecryptShort DecryptShort will decrypt a previously encrypted short-integer buffer using the current TDES- or DEScipher/ActiveX control settings.

EncryptShort EncryptShort will encrypt a short-integer buffer using the current TDES- or DEScipher/ActiveX control settings.

DecryptLong DecryptLong will decrypt a previously encrypted long-integer buffer using the current TDES- or DEScipher/ActiveX control settings.

EncryptLong EncryptLong will encrypt a long-integer buffer using the current TDES- or DEScipher/ActiveX control settings.

DecryptSingle DecryptSingle will decrypt a previously encrypted single-precision floating-point buffer using the current TDES- or DEScipher/ActiveX control settings.

EncryptSingle EncryptSingle will encrypt a single-precision floating-point buffer using the current TDES- or DEScipher/ActiveX control settings.

DecryptDouble DecryptDouble will decrypt a previously encrypted double-precision floating-point buffer using the current TDES- or DEScipher/ActiveX control settings.

EncryptDouble EncryptDouble will encrypt a double-precision floating-point buffer using the current TDES- or DEScipher/ActiveX control settings.

DecryptString DecryptString will decrypt a previously encrypted Visual Basic String using the current TDES- or DEScipher/ActiveX control settings.

EncryptString EncryptString will encrypt a Visual Basic String using the current TDES- or DEScipher/ActiveX control settings.

DESReset DESReset will reset the TDES- or DEScipher/ActiveX encryption/decryption module to its start state (retaining the current InitVector and CipherKey values).

***TDES- and DEScipher/ActiveX Methods***
Method	Description
DecryptShort	DecryptShort will decrypt a previously encrypted short-integer buffer using the current TDES- or DEScipher/ActiveX control settings.
EncryptShort	EncryptShort will encrypt a short-integer buffer using the current TDES- or DEScipher/ActiveX control settings.
DecryptLong	DecryptLong will decrypt a previously encrypted long-integer buffer using the current TDES- or DEScipher/ActiveX control settings.
EncryptLong	EncryptLong will encrypt a long-integer buffer using the current TDES- or DEScipher/ActiveX control settings.
DecryptSingle	DecryptSingle will decrypt a previously encrypted single-precision floating-point buffer using the current TDES- or DEScipher/ActiveX control settings.
EncryptSingle	EncryptSingle will encrypt a single-precision floating-point buffer using the current TDES- or DEScipher/ActiveX control settings.
DecryptDouble	DecryptDouble will decrypt a previously encrypted double-precision floating-point buffer using the current TDES- or DEScipher/ActiveX control settings.
EncryptDouble	EncryptDouble will encrypt a double-precision floating-point buffer using the current TDES- or DEScipher/ActiveX control settings.
DecryptString	DecryptString will decrypt a previously encrypted Visual Basic String using the current TDES- or DEScipher/ActiveX control settings.
EncryptString	EncryptString will encrypt a Visual Basic String using the current TDES- or DEScipher/ActiveX control settings.
DESReset	DESReset will reset the TDES- or DEScipher/ActiveX encryption/decryption module to its start state (retaining the current InitVector and CipherKey values).

TDES- and DEScipher/ActiveX Error Codes
Error Description

DES_ERRINVMODE The DESMode Property has been set to an invalid value.

DES_ERRBADBLOCKSIZE The BlockSize Property has been set to an invalid value.

DES_ERRINVKEYLEN The specified encryption key is not 16 characters long.

DES_ERRINVHEXDIGIT The specified key string contains an invalid character.

DES_ERRINVIVLEN The specified initialization vector is not 16 characters long.

DES_ERRPARITY The specified key string does not have odd parity.

DES_ERRKEYUNDEF The CipherKey Property has not been defined.

DES_ERRIVUNDEF The InitVector Property has not been defined.

DES_ERRSHORTSTRING The specified input string is less than BufferSize bytes in length.

DES_ERRWEAKKEY The specified key belongs to the set of “weak keys” and is therefore not secure.

***TDES- and DEScipher/ActiveX Error Codes***
Error	Description
DES_ERRINVMODE	The DESMode Property has been set to an invalid value.
DES_ERRBADBLOCKSIZE	The BlockSize Property has been set to an invalid value.
DES_ERRINVKEYLEN	The specified encryption key is not 16 characters long.
DES_ERRINVHEXDIGIT	The specified key string contains an invalid character.
DES_ERRINVIVLEN	The specified initialization vector is not 16 characters long.
DES_ERRPARITY	The specified key string does not have odd parity.
DES_ERRKEYUNDEF	The CipherKey Property has not been defined.
DES_ERRIVUNDEF	The InitVector Property has not been defined.
DES_ERRSHORTSTRING	The specified input string is less than BufferSize bytes in length.
DES_ERRWEAKKEY	The specified key belongs to the set of “weak keys” and is therefore not secure.

OPTIONS:

HOME | RESOURCE PAGE | BACK TO DEScipher PAGE

Copyright ©, 1995-2000 Bokler Software Corp. All rights reserved. DEScipher, TDEScipher and HASHcipher are trademarks of Bokler Software Corp. Microsoft, Visual Basic, ActiveX and Windows are trademarks of Microsoft Corp.