Extract Protected Container Files
This section describes how to extract container files that are protected with a password or require other types of credentials.
The following guidelines apply to specific file types.
- Lotus Notes NSF files. If you are running a Notes client with an active user connected to a Domino server, you must specify the user’s password as a credential regardless of whether the NSF files you are opening are protected. This enables File Content Extraction to access the Notes client and the Lotus Notes API. If the Notes client is not running with an active user, the password is not required.
- PST files. To open password-protected PST files that use high encryption (Microsoft Outlook 2003 only), you must use the MAPI-based PST reader (
pstsr
). The native PST readers (pstxsr
andpstnsr
) do not support files that use high encryption and return the error messageKVERR_PasswordProtected
if a PST file is encrypted with high encryption.
To supply credentials for opening protected container files
-
In the .NET API, call the
Credentials
method on your session configuration. This provides credentials for the session rather than a single file, but you can supply multiple sets of credentials, and the credentials can be of multiple types.For example, to supply a password for extracting subfiles from a password-protected zip file, you might use the following code:
Copyvar credentials = new List<CredentialComponent>
{
new CredentialComponent(CredentialKeyType.Password, "secret123")
};
session.Config().Credentials(credentials);To remove all credentials from the session configuration, call the
Credentials
method without supplying any credentials:Copysession.Config().Credentials();
When you attempt to open a protected container file, but do not provide any credentials through the
Credentials
method, File Content Extraction will attempt to use any credentials provided through thePassword
method (see Filter Password Protected Files).