CryptoSys API Library Manual

DES_FileHex

Encrypts or decrypts a file using a specified mode. The key and initialization vector are passed as hexadecimal strings.

VBA/VB6 Syntax

Public Declare Function DES_FileHex Lib "diCryptoSys.dll" (ByVal strFileOut As String, ByVal strFileIn As String, ByVal strHexKey As String, ByVal bEncrypt As Boolean, ByVal strMode As String, ByVal strHexIV As String) As Long

nRet = DES_FileHex(strFileOut, strFileIn, strHexKey, bEncrypt, strMode, strHexIV)

C/C++ Syntax

long __stdcall DES_FileHex(const char *szFileOut, const char *szFileIn, const char *szKey, int fEncrypt, const char *szMode, const char *szIV);

Parameters

szFileOut
[in] with the full path name of the output file to be created.
szFileIn
[in] with the full path name of the input file to be processed.
szKey
[in] containing the key in hexadecimal.
fEncrypt
[in] direction flag: set as ENCRYPT (True) to encrypt or DECRYPT (False) to decrypt.
szMode
[in] specifying the confidentiality mode:
"ECB" for Electronic Codebook mode,
"CBC" for Cipher Block Chaining mode,
"CFB" for 64-bit Cipher Feedback mode,
"OFB" for Output Feedback mode, or
"CTR" for Counter mode.
szIV
[in] containing the initialization vector (IV) in hexadecimal.

Returns (VBA/C)

If successful, the return value is 0; otherwise it returns a non-zero error code.

.NET Equivalent

Des.FileEncrypt Method (String, String, String, Mode, String)
Des.FileDecrypt Method (String, String, String, Mode, String)

Remarks

Both the key string szHexKey and the initialization vector szHexIV must be exactly 16 hex characters long (i.e. representing exactly 8 bytes), unless szMode is ECB, in which case szIV is ignored (use ""). Valid hexadecimal characters are [0-9A-Fa-f]. The output file szFileOut will be overwritten without warning. If there is an error [new in version 3.3], the output file will not exist. The input and output filepaths must not be the same. In ECB and CBC modes, a padding string will be added or assumed according to the method outlined in Section 6.3 of [CMS], which is the same as the padding method in [PKCS7] and [PKCS5].

Note that even though the parameters are in hexadecimal-encoded form, the encrypted file is still binary.

Example

This example will encrypt the file "bigfile.dat" in CBC mode using the key 0xfedcba9876543210 and initialization vector 0x0123456789abcdef. The output file "bigfile.cbc" will be created or overwritten. It then decrypts the ciphertext file as a check, creating or overwriting the file "bigfile.chk".

    Dim nRet As Long

    nRet = DES_FileHex("bigfile.cbc", "bigfile.dat", _
        "fedcba9876543210", ENCRYPT, "CBC", "0123456789abcdef")
    Debug.Print nRet

    ' and decrypt it as a check
    nRet = DES_FileHex("bigfile.chk", "bigfile.cbc", _
        "fedcba9876543210fedcba9876543210", DECRYPT, "CBC", "0123456789abcdef")
    Debug.Print nRet

See Also

DES_File

[Contents] [Index]

[PREV: DES_FileExt...]   [Contents]   [Index]   
   [NEXT: DES_Final...]

Copyright © 2001-24 D.I. Management Services Pty Ltd. All rights reserved. Generated 2024-01-07T07:42:00Z.