AES128_File encrypts or decrypts a file
using a specified mode. The key and initialization vector
are passed as arrays of bytes.
Public Declare Function AES128_File Lib "diCryptoSys.dll"
(ByVal strFileOut As String, ByVal strFileIn As String,
ByRef abKey As Byte,
ByVal bEncrypt As Boolean, ByVal strMode As String, ByRef abInitV As Byte) As Long
nRet = AES128_File(strFileOut, strFileIn, abKey(0), bEncrypt, strMode, abInitV(0))
String with the full path name of the output
file to be created.String with the full path name of the input file
to be processed.Byte array containing the key.Boolean direction flag:
set as True to encrypt or False
to decrypt.String specifying the confidentiality mode:Byte array containing the initialization vector (IV),
or zero (0) for ECB mode.
long _stdcall AES128_File(const char *lpszFileOut, const char *lpszFileIn,
const unsigned char *key, int bEncrypt, const char *lpszMode, const unsigned char *iv);
Long: If successful, the return value is 0;
otherwise it returns a non-zero error code.
Aes128.FileEncrypt Method (String, String, Byte[], Mode, Byte[])
Aes128.FileDecrypt Method (String, String, Byte[], Mode, Byte[])
The key array abKey()
must be exactly 16 bytes long.
The initialization vector abInitV()
must be exactly the block size of 16 bytes long, except for ECB mode, where it is ignored (use 0).
The output file strFileOut 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].
This example will encrypt the file "now.txt" in ECB mode using the 128-bit key 0xfedcba9876543210fedcba9876543210, and then decrypt back to the plain text file "aesnow.chk" as a check. Both output files "aesnow.enc" and "aesnow.chk" will be created or overwritten.
Const MY_PATH As String = "C:\Test\"
Dim strFileOut As String, strFileIn As String, strFileChk As String
Dim nRet As Long
Dim abKey() As Byte
' Construct full path names to files
strFileIn = MY_PATH & "now.txt"
strFileOut = MY_PATH & "now.aes128.enc.dat"
strFileChk = MY_PATH & "now.aes128.chk.txt"
' Convert key to byte array
abKey = cnvBytesFromHexStr("0123456789ABCDEFF0E1D2C3B4A59687")
' Encrypt plaintext file to cipher
nRet = AES128_File(strFileOut, strFileIn, abKey(0), ENCRYPT, "ECB", 0)
If nRet <> 0 Then
Debug.Print "Error " & nRet & ": " & apiErrorLookup(nRet)
End If
' Now decrypt it
nRet = AES128_File(strFileChk, strFileOut, abKey(0), DECRYPT, "ECB", 0)
If nRet <> 0 Then
Debug.Print "Error " & nRet & ": " & apiErrorLookup(nRet)
End If