sync toc
+ CryptoSysTM API Manual
o What is the CryptoSys API?
o Introduction
o Getting Started
o Changes in this version
o Changes in earlier versions
o Conventions in this document
o Copyright Notice
+ Background Basics
o Block cipher algorithms
o Block Cipher Modes and Initialization Vectors
o Padding
o Stream ciphers
o One-way message digest (hash) functions
o Message authentication code (MAC) functions
o Galois/Counter Mode (GCM) Authenticated Encryption
o Data Compression in Cryptography
+ Secure Random Number Generator
o RNG Mechanisms
o Techniques to add known security strength to the RNG process
o User-supplied entropy (seeds)
+ Installation
o Win64 (X64) Platform
o Detecting Win32 or X64 platform
o Visual Basic or Visual Basic: VB6 vs VB.NET
+ General Programming Issues
o Storing and representing ciphertext
o Converting strings to bytes and vice versa
o Hexadecimal versus Bytes
o Return Values
+ Using with Classic Visual Basic and VBA
o Pre-dimensioning for VB
+ Using with C and C++
o Type Conversions
o Compiling with C
o Using With Borland C++
o Cautions for C/C++ Users
+ Using with .NET: C# and VB.NET
o Converting VB6 to VB.NET
o Using with COM/ASP
o 'Hello world' programs
o Common problems when encrypting
o Specifying the algorithm and mode for generic block cipher functions
o Extensions to block cipher functions for files
o Security Issues
o Self-Tests
o Optional Registry Settings
o Technical Details
o Compliance
o References
+ VB6/C Function Summary
o Advanced Encryption Standard (AES) functions
o Blowfish functions
o Conversion functions
o Cyclic Redundancy Check functions
o Data Encryption Standard (DES) functions
o Message Digest Hash functions
o GCM functions
o General functions
o Message Authentication Code functions
o MD5 Hash Algorithm functions
o Padding functions
o Password-based encryption functions
o PC1 Stream Cipher functions
o Secure Random Number Generator (RNG) functions
o Secure Hash Algorithm (SHA-1) functions
o Secure Hash Algorithm (SHA-256) functions
o Triple Data Encryption Algorithm (Triple DES) functions
o Wipe functions
o Key Wrap functions
o ZLIB data compression functions
o ActiveX Interface
o Deprecated Functions
+ List of Functions
o AES128_B64Mode
o AES128_Bytes
o AES128_BytesMode
o AES128_File
o AES128_FileExt
o AES128_FileHex
o AES128_Final
o AES128_Hex
o AES128_HexMode
o AES128_Init
o AES128_InitError
o AES128_InitHex
o AES128_Update
o AES128_UpdateHex
o AES192_B64Mode
o AES192_Bytes
o AES192_BytesMode
o AES192_File
o AES192_FileExt
o AES192_FileHex
o AES192_Final
o AES192_Hex
o AES192_HexMode
o AES192_Init
o AES192_InitError
o AES192_InitHex
o AES192_Update
o AES192_UpdateHex
o AES256_B64Mode
o AES256_Bytes
o AES256_BytesMode
o AES256_File
o AES256_FileExt
o AES256_FileHex
o AES256_Final
o AES256_Hex
o AES256_HexMode
o AES256_Init
o AES256_InitError
o AES256_InitHex
o AES256_Update
o AES256_UpdateHex
o API_CompileTime
o API_ErrorCode
o API_ErrorLookup
o API_LicenceType
o API_ModuleName
o API_PowerUpTests
o API_Version
o BLF_B64Mode
o BLF_Bytes
o BLF_BytesMode
o BLF_File
o BLF_FileExt
o BLF_FileHex
o BLF_Final
o BLF_Hex
o BLF_HexMode
o BLF_Init
o BLF_InitError
o BLF_InitHex
o BLF_Update
o BLF_UpdateHex
o CNV_B64Filter
o CNV_B64StrFromBytes
o CNV_BytesFromB64Str
o CNV_BytesFromHexStr
o CNV_HexFilter
o CNV_HexStrFromBytes
o CIPHER_KeyWrap
o CIPHER_KeyUnwrap
o CRC_Bytes
o CRC_File
o CRC_String
o DES_B64Mode
o DES_Bytes
o DES_BytesMode
o DES_CheckKey
o DES_CheckKeyHex
o DES_File
o DES_FileExt
o DES_FileHex
o DES_Final
o DES_Hex
o DES_HexMode
o DES_Init
o DES_InitError
o DES_InitHex
o DES_Update
o DES_UpdateHex
o GCM_Decrypt
o GCM_Encrypt
o GCM_FinishKey
o GCM_InitKey
o GCM_NextDecrypt
o GCM_NextEncrypt
o HASH_Bytes
o HASH_File
o HASH_HexFromBytes
o HASH_HexFromFile
o HASH_HexFromHex
o MAC_Bytes
o MAC_HexFromBytes
o MAC_HexFromHex
o MD5_AddBytes
o MD5_AddString
o MD5_BytesHash
o MD5_BytesHexHash
o MD5_FileHexHash
o MD5_HexDigest
o MD5_Hmac
o MD5_HmacHex
o MD5_Init
o MD5_Reset
o MD5_StringHexHash
o PAD_BytesBlock
o PAD_HexBlock
o PAD_UnpadBytes
o PAD_UnpadHex
o PBE_Kdf2
o PBE_Kdf2Hex
o PC1_Bytes
o PC1_File
o PC1_Hex
o RNG_BytesWithPrompt
o RNG_HexWithPrompt
o RNG_Initialize
o RNG_KeyBytes
o RNG_KeyHex
o RNG_MakeSeedFile
o RNG_NonceData
o RNG_NonceDataHex
o RNG_Number
o RNG_Test
o RNG_UpdateSeedFile
o SHA1_AddBytes
o SHA1_AddString
o SHA1_BytesHash
o SHA1_BytesHexHash
o SHA1_FileHexHash
o SHA1_HexDigest
o SHA1_Hmac
o SHA1_HmacHex
o SHA1_Init
o SHA1_Reset
o SHA1_StringHexHash
o SHA2_AddBytes
o SHA2_AddString
o SHA2_BytesHash
o SHA2_BytesHexHash
o SHA2_FileHexHash
o SHA2_HexDigest
o SHA2_Hmac
o SHA2_HmacHex
o SHA2_Init
o SHA2_Reset
o SHA2_StringHexHash
o TDEA_B64Mode
o TDEA_Bytes
o TDEA_BytesMode
o TDEA_File
o TDEA_FileExt
o TDEA_FileHex
o TDEA_Final
o TDEA_Hex
o TDEA_HexMode
o TDEA_Init
o TDEA_InitError
o TDEA_InitHex
o TDEA_Update
o TDEA_UpdateHex
o WIPE_Data
o WIPE_File
o ZLIB_Deflate
o ZLIB_Inflate
o ActiveX Classes and Methods
+ .NET Classes and Methods
o Cross-reference between Functions and .NET Methods
o .NET Help File
+ Summary of .NET Classes
o Aes128 Class
o Aes192 Class
o Aes256 Class
o Blowfish Class
o Cipher Class
o Cnv Class
o Crc Class
o Des Class
o Gcm Class
o General Class
o Hash Class
o Mac Class
o Md5 Class
o Pbe Class
o Pc1 Class
o Properties Class
o Rng Class
o Sha1 Class
o Sha256 Class
o Tdea Class
o Wipe Class
o Zlib Class
+ List of .Net Methods
o Aes128.Decrypt Method (Byte, Byte, Mode, Byte)
o Aes128.Decrypt Method (String, String, Mode, String)
o Aes128.Decrypt Method (String, String, Mode, String, EncodingBase)
o Aes128.Dispose Method
o Aes128.Encrypt Method (Byte, Byte, Mode, Byte)
o Aes128.Encrypt Method (String, String, Mode, String)
o Aes128.Encrypt Method (String, String, Mode, String, EncodingBase)
o Aes128.FileDecrypt Method (String, String, Byte, Mode, Byte)
o Aes128.FileDecrypt Method (String, String, String, Mode, String)
o Aes128.FileEncrypt Method (String, String, Byte, Mode, Byte)
o Aes128.FileEncrypt Method (String, String, Byte, Mode, Byte, CipherFileOption)
o Aes128.FileDecrypt Method (String, String, Byte, Mode, Byte, CipherFileOption)
o Aes128.FileEncrypt Method (String, String, String, Mode, String)
o Aes128.InitDecrypt Method (Byte, Mode, Byte)
o Aes128.InitDecrypt Method (String, Mode, String)
o Aes128.InitEncrypt Method (Byte, Mode, Byte)
o Aes128.InitEncrypt Method (String, Mode, String)
o Aes128.Instance Method
o Aes128.Pad Method (Byte)
o Aes128.Pad Method (String)
o Aes128.Unpad Method (Byte)
o Aes128.Unpad Method (String)
o Aes128.Update Method (Byte)
o Aes128.Update Method (String)
o Aes192.Decrypt Method (Byte, Byte, Mode, Byte)
o Aes192.Decrypt Method (String, String, Mode, String)
o Aes192.Decrypt Method (String, String, Mode, String, EncodingBase)
o Aes192.Dispose Method
o Aes192.Encrypt Method (Byte, Byte, Mode, Byte)
o Aes192.Encrypt Method (String, String, Mode, String)
o Aes192.Encrypt Method (String, String, Mode, String, EncodingBase)
o Aes192.FileDecrypt Method (String, String, Byte, Mode, Byte)
o Aes192.FileDecrypt Method (String, String, String, Mode, String)
o Aes192.FileEncrypt Method (String, String, Byte, Mode, Byte)
o Aes192.FileEncrypt Method (String, String, Byte, Mode, Byte, CipherFileOption)
o Aes192.FileDecrypt Method (String, String, Byte, Mode, Byte, CipherFileOption)
o Aes192.FileEncrypt Method (String, String, String, Mode, String)
o Aes192.InitDecrypt Method (Byte, Mode, Byte)
o Aes192.InitDecrypt Method (String, Mode, String)
o Aes192.InitEncrypt Method (Byte, Mode, Byte)
o Aes192.InitEncrypt Method (String, Mode, String)
o Aes192.Instance Method
o Aes192.Pad Method (Byte)
o Aes192.Pad Method (String)
o Aes192.Unpad Method (Byte)
o Aes192.Unpad Method (String)
o Aes192.Update Method (Byte)
o Aes192.Update Method (String)
o Aes256.Decrypt Method (Byte, Byte, Mode, Byte)
o Aes256.Decrypt Method (String, String, Mode, String)
o Aes256.Decrypt Method (String, String, Mode, String, EncodingBase)
o Aes256.Dispose Method
o Aes256.Encrypt Method (Byte, Byte, Mode, Byte)
o Aes256.Encrypt Method (String, String, Mode, String)
o Aes256.Encrypt Method (String, String, Mode, String, EncodingBase)
o Aes256.FileDecrypt Method (String, String, Byte, Mode, Byte)
o Aes256.FileDecrypt Method (String, String, String, Mode, String)
o Aes256.FileEncrypt Method (String, String, Byte, Mode, Byte)
o Aes256.FileEncrypt Method (String, String, Byte, Mode, Byte, CipherFileOption)
o Aes256.FileDecrypt Method (String, String, Byte, Mode, Byte, CipherFileOption)
o Aes256.FileEncrypt Method (String, String, String, Mode, String)
o Aes256.InitDecrypt Method (Byte, Mode, Byte)
o Aes256.InitDecrypt Method (String, Mode, String)
o Aes256.InitEncrypt Method (Byte, Mode, Byte)
o Aes256.InitEncrypt Method (String, Mode, String)
o Aes256.Instance Method
o Aes256.Pad Method (Byte)
o Aes256.Pad Method (String)
o Aes256.Unpad Method (Byte)
o Aes256.Unpad Method (String)
o Aes256.Update Method (Byte)
o Aes256.Update Method (String)
o Blowfish.Decrypt Method (Byte, Byte, Mode, Byte)
o Blowfish.Decrypt Method (String, String, Mode, String)
o Blowfish.Decrypt Method (String, String, Mode, String, EncodingBase)
o Blowfish.Dispose Method
o Blowfish.Encrypt Method (Byte, Byte, Mode, Byte)
o Blowfish.Encrypt Method (String, String, Mode, String)
o Blowfish.Encrypt Method (String, String, Mode, String, EncodingBase)
o Blowfish.FileDecrypt Method (String, String, Byte, Mode, Byte)
o Blowfish.FileDecrypt Method (String, String, String, Mode, String)
o Blowfish.FileEncrypt Method (String, String, Byte, Mode, Byte)
o Blowfish.FileEncrypt Method (String, String, Byte, Mode, Byte, CipherFileOption)
o Blowfish.FileDecrypt Method (String, String, Byte, Mode, Byte, CipherFileOption)
o Blowfish.FileEncrypt Method (String, String, String, Mode, String)
o Blowfish.InitDecrypt Method (Byte, Mode, Byte)
o Blowfish.InitDecrypt Method (String, Mode, String)
o Blowfish.InitEncrypt Method (Byte, Mode, Byte)
o Blowfish.InitEncrypt Method (String, Mode, String)
o Blowfish.Instance Method
o Blowfish.Pad Method (Byte)
o Blowfish.Pad Method (String)
o Blowfish.Unpad Method (Byte)
o Blowfish.Unpad Method (String)
o Blowfish.Update Method (Byte)
o Blowfish.Update Method (String)
o Cipher.KeyUnwrap Method
o Cipher.KeyWrap Method
o Cnv.Base64Filter Method
o Cnv.Base64FromHex Method
o Cnv.FromBase64 Method
o Cnv.FromHex Method
o Cnv.HexFilter Method
o Cnv.HexFromBase64 Method
o Cnv.StringFromBase64 Method
o Cnv.StringFromHex Method
o Cnv.ToBase64 Method (Byte)
o Cnv.ToBase64 Method (String)
o Cnv.ToHex Method (Byte)
o Cnv.ToHex Method (String)
o Crc.Data Method (Byte)
o Crc.Data Method (String)
o Crc.File Method
o Des.CheckKey Method (Byte)
o Des.CheckKey Method (String)
o Des.Decrypt Method (Byte, Byte, Mode, Byte)
o Des.Decrypt Method (String, String, Mode, String)
o Des.Decrypt Method (String, String, Mode, String, EncodingBase)
o Des.Dispose Method
o Des.Encrypt Method (Byte, Byte, Mode, Byte)
o Des.Encrypt Method (String, String, Mode, String)
o Des.Encrypt Method (String, String, Mode, String, EncodingBase)
o Des.FileDecrypt Method (String, String, Byte, Mode, Byte)
o Des.FileEncrypt Method (String, String, Byte, Mode, Byte, CipherFileOption)
o Des.FileDecrypt Method (String, String, Byte, Mode, Byte, CipherFileOption)
o Des.FileDecrypt Method (String, String, String, Mode, String)
o Des.FileEncrypt Method (String, String, Byte, Mode, Byte)
o Des.FileEncrypt Method (String, String, String, Mode, String)
o Des.InitDecrypt Method (Byte, Mode, Byte)
o Des.InitDecrypt Method (String, Mode, String)
o Des.InitEncrypt Method (Byte, Mode, Byte)
o Des.InitEncrypt Method (String, Mode, String)
o Des.Instance Method
o Des.Pad Method (Byte)
o Des.Pad Method (String)
o Des.Unpad Method (Byte)
o Des.Unpad Method (String)
o Des.Update Method (Byte)
o Des.Update Method (String)
o Gcm.Decrypt Method
o Gcm.Dispose Method
o Gcm.Encrypt Method
o Gcm.Gmac Method
o Gcm.InitKey Method
o Gcm.Instance Method
o Gcm.NextDecrypt Method
o Gcm.NextEncrypt Method
o Gcm.NextGmac Method
o General.CompileTime Method
o General.ErrorCode Method
o General.ErrorLookup Method
o General.IsWin64 Method
o General.LicenceType Method
o General.ModuleName Method
o General.Platform Method
o General.PowerUpTests Method
o General.Version Method
o Hash.BytesFromBytes Method
o Hash.BytesFromFile Method
o Hash.HexFromBytes Method
o Hash.HexFromFile Method
o Hash.HexFromHex Method
o Hash.HexFromString Method
o Hash.HexFromTextFile Method
o Mac.BytesFromBytes Method
o Mac.HexFromBytes Method
o Mac.HexFromHex Method
o Md5.AddData Method (Byte)
o Md5.AddData Method (String)
o Md5.BytesHash Method
o Md5.Dispose Method
o Md5.FileHexHash Method
o Md5.FileTextHexHash Method
o Md5.HexDigest Method
o Md5.HexHash Method (Byte)
o Md5.HexHash Method (String)
o Md5.Hmac Method (Byte, Byte)
o Md5.Hmac Method (String, String)
o Md5.Init Method
o Md5.Instance Method
o Md5.Reset Method
o Pbe.Kdf2 Method (Int32, Byte, Byte, Int32)
o Pbe.Kdf2 Method (Int32, Byte, Byte, Int32, HashAlgorithm)
o Pbe.Kdf2 Method (Int32, String, String, Int32)
o Pbe.Kdf2 Method (Int32, String, String, Int32, HashAlgorithm)
o Pc1.Encrypt Method (Byte, Byte)
o Pc1.Encrypt Method (String, String)
o Pc1.File Method
o Rng.BytesWithPrompt Method (Int32)
o Rng.BytesWithPrompt Method (Int32, String, Rng.Strength)
o Rng.HexWithPrompt Method (Int32)
o Rng.HexWithPrompt Method (Int32, String, Rng.Strength)
o Rng.Initialize Method
o Rng.KeyBytes Method (Int32, Byte)
o Rng.KeyBytes Method (Int32, String)
o Rng.KeyHex Method (Int32, Byte)
o Rng.KeyHex Method (Int32, String)
o Rng.MakeSeedFile Method (String)
o Rng.MakeSeedFile Method (String, String, Rng.Strength)
o Rng.NonceBytes Method
o Rng.NonceHex Method
o Rng.Number Method
o Rng.Octet Method
o Rng.Test Method
o Rng.UpdateSeedFile Method
o Sha1.AddData Method (Byte)
o Sha1.AddData Method (String)
o Sha1.BytesHash Method
o Sha1.Dispose Method
o Sha1.FileHexHash Method
o Sha1.FileTextHexHash Method
o Sha1.HexDigest Method
o Sha1.HexHash Method (Byte)
o Sha1.HexHash Method (String)
o Sha1.Hmac Method (Byte, Byte)
o Sha1.Hmac Method (String, String)
o Sha1.Init Method
o Sha1.Instance Method
o Sha1.Reset Method
o Sha256.AddData Method (Byte)
o Sha256.AddData Method (String)
o Sha256.BytesHash Method
o Sha256.Dispose Method
o Sha256.FileHexHash Method
o Sha256.FileTextHexHash Method
o Sha256.HexDigest Method
o Sha256.HexHash Method (Byte)
o Sha256.HexHash Method (String)
o Sha256.Hmac Method (Byte, Byte)
o Sha256.Hmac Method (String, String)
o Sha256.Init Method
o Sha256.Instance Method
o Sha256.Reset Method
o Tdea.CheckKey Method (Byte)
o Tdea.CheckKey Method (String)
o Tdea.Decrypt Method (Byte, Byte, Mode, Byte)
o Tdea.Decrypt Method (String, String, Mode, String)
o Tdea.Decrypt Method (String, String, Mode, String, EncodingBase)
o Tdea.Dispose Method
o Tdea.Encrypt Method (Byte, Byte, Mode, Byte)
o Tdea.Encrypt Method (String, String, Mode, String)
o Tdea.Encrypt Method (String, String, Mode, String, EncodingBase)
o Tdea.FileDecrypt Method (String, String, Byte, Mode, Byte)
o Tdea.FileEncrypt Method (String, String, Byte, Mode, Byte, CipherFileOption)
o Tdea.FileDecrypt Method (String, String, Byte, Mode, Byte, CipherFileOption)
o Tdea.FileDecrypt Method (String, String, String, Mode, String)
o Tdea.FileEncrypt Method (String, String, Byte, Mode, Byte)
o Tdea.FileEncrypt Method (String, String, String, Mode, String)
o Tdea.InitDecrypt Method (Byte, Mode, Byte)
o Tdea.InitDecrypt Method (String, Mode, String)
o Tdea.InitEncrypt Method (Byte, Mode, Byte)
o Tdea.InitEncrypt Method (String, Mode, String)
o Tdea.Instance Method
o Tdea.Pad Method (Byte)
o Tdea.Pad Method (String)
o Tdea.Unpad Method (Byte)
o Tdea.Unpad Method (String)
o Tdea.Update Method (Byte)
o Tdea.Update Method (String)
o Wipe.Data Method
o Wipe.File Method
o Wipe.String Method
o Zlib.Deflate Method
o Zlib.Inflate Method
o Aes128.ErrCode Property
o Aes192.ErrCode Property
o Aes256.ErrCode Property
o Blowfish.ErrCode Property
o Des.ErrCode Property
o Gcm.ErrCode Property
o Md5.ErrCode Property
o Sha1.ErrCode Property
o Sha256.ErrCode Property
o Tdea.ErrCode Property
o CipherFileOption Enumeration
+ Example code in VB.NET (VB2005/8/x)
o Example: Aes128.Decrypt 
o Example: Aes128.Decrypt 
o Example: Aes128.Decrypt 
o Example: Aes128.FileDecrypt 
o Example: Aes128.FileEncrypt 
o Example: Aes128.Decrypt 
o Example: Aes128.Decrypt 
o Example: Aes128.ErrCode 
o Example: Aes128.Dispose 
o Example: Aes128.Dispose 
o Example: Aes192.Decrypt 
o Example: Aes256.Decrypt 
o Example: General.CompileTime 
o Example: General.ErrorLookup 
o Example: General.ErrorLookup 
o Example: General.LicenceType 
o Example: General.PowerUpTests 
o Example: General.Version 
o Example: Blowfish.Decrypt 
o Example: Blowfish.Decrypt 
o Example: Blowfish.Decrypt 
o Example: Blowfish.FileDecrypt 
o Example: Blowfish.FileEncrypt 
o Example: Blowfish.Decrypt 
o Example: Blowfish.Decrypt 
o Example: Blowfish.Dispose 
o Example: Blowfish.Dispose 
o Example: Cipher.KeyUnwrap 
o Example: Cipher.KeyUnwrap 
o Example: Crc.Data 
o Example: Crc.File 
o Example: Crc.Data 
o Example: Des.Decrypt 
o Example: Gcm.Decrypt 
o Example: Gcm.Gmac 
o Example: Gcm.Dispose 
o Example: Hash.BytesFromBytes 
o Example: Hash.BytesFromFile 
o Example: Hash.HexFromBytes 
o Example: Hash.HexFromHex 
o Example: Mac.BytesFromBytes 
o Example: Mac.HexFromBytes 
o Example: Mac.HexFromHex 
o Example: Md5.AddData 
o Example: Md5.AddData 
o Example: Md5.BytesHash 
o Example: Md5.HexHash 
o Example: Tdea.Pad 
o Example: Tdea.Pad 
o Example: Tdea.Unpad 
o Example: Pbe.Kdf2 
o Example: Pbe.Kdf2 
o Example: Pc1.Encrypt 
o Example: Pc1.File 
o Example: Pc1.Encrypt 
o Example: Rng.Initialize 
o Example: Rng.KeyBytes 
o Example: Rng.MakeSeedFile 
o Example: Rng.NonceHex 
o Example: Rng.Number 
o Example: Sha1.AddData 
o Example: Sha1.BytesHash 
o Example: Sha1.FileHexHash 
o Example: Sha1.HexHash 
o Example: Sha256.HexHash 
o Example: Tdea.Decrypt 
o Example: Tdea.Decrypt 
o Example: Tdea.Decrypt 
o Example: Tdea.FileDecrypt 
o Example: Tdea.FileDecrypt 
o Example: Tdea.Decrypt 
o Example: Tdea.Dispose 
o Example: Wipe.Data 
o Example: Wipe.String 
o Example: Zlib.Deflate 
o Error Codes
o Acknowledgements
o Index
o Document Revision History