encryptionInfo()

This function detects the type of encryption applied to a document, and information about the level to which Panopticon supports decryption. This information can be used to determine whether this file should be passed to decryptFile().

Syntax

KVPanopticonError encryptionInfo(
   KVPanopticonContext* const context,
   const char* const inputFilePath,
   KVPanopticonEncryptionInfo* const encryptionInfo /*out*/
);

Arguments

context

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

inputFilePath

A null-terminated C string that contains the path of the file to get encryption info for.

encryptionInfo

A pointer to a KVPanopticonEncryptionInfo. If the function completes successfully, it fills this structure out with the encryption information.

You must initialize the KVStructHead structure by using the macro KVStructInit.

Returns

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

Discussion

After you call this function, you must free the memory it allocates by using resetEncryptionInfo() before you call shutdown()