decryptFile()

This function removes the encryption on a protected file, giving access to the original, unencrypted file.

Syntax

KVPanopticonError decryptFile(
   KVPanopticonContext* const context,
   const char* const inputFilePath,
   const char* const outputFilePath
);

Arguments

context

A pointer to KVPanopticonContext, initialized by calling init().

inputFilePath

A null-terminated C string that contains the path of the file to decrypt.

outputFilePath

A null-terminated C string that contains the path of the output file to create. If a file already exists at this location, Panopticon overwrites it.

Returns

If the function was successful, it returns KVP_Success. Otherwise, it returns a KVPanopticonError value describing the problem.

Discussion

  • To decrypt a protected file, Panopticon must make an HTTP request.

  • By default, Panopticon uses the system proxy when it makes HTTP requests. You can also specify the proxy manually in the cryptographyservices.cfg. See Configure the Proxy for RMS.

  • This function returns an error if decryption is not supported for the inputFile you provide. You can obtain information about the level of support provided by using encryptionInfo().