ICertificate2::Load method

[CAPICOM is a 32-bit only component that is available for use in the following operating systems: Windows Server 2008, Windows Vista, and Windows XP. Instead, use the X509Certificate2 Class in the System.Security.Cryptography.X509Certificates namespace.]

The Load method imports a certificate from a file. This method was introduced in CAPICOM 2.0.


Certificate.Load( _
  ByVal FileName, _
  [ ByVal Password ], _
  [ ByVal KeyStorageFlag ], _
  [ ByVal KeyLocation ] _


FileName [in]

A string that contains the path to a .cer or .pfx file that contains the certificate data.

Password [in, optional]

A string that contains the plaintext password to the private key file. The password can contain up to 32 Unicode characters, including a terminating null character. For information about protecting the password, see Handling Passwords.

KeyStorageFlag [in, optional]

A value of the CAPICOM_KEY_STORAGE_FLAG enumeration that defines key storage flags. The default is CAPICOM_KEY_STORAGE_DEFAULT. The following table shows the possible values.

Value Meaning
Default key storage.
The key is exportable.
The key is user protected.


KeyLocation [in, optional]

A value of the CAPICOM_KEY_LOCATION enumeration that defines key location types. The default value is CAPICOM_CURRENT_USER_KEY. The following table shows the possible values.

Value Meaning
The key is a user key.
The key is a machine key.


Return value

This method does not return a value.


This method raises CAPICOM_E_NOT_ALLOWED when it is scripted from a web-based application.


Requirement Value
End of client support
Windows Vista
End of server support
Windows Server 2008
CAPICOM 2.0 or later on Windows Server 2003 and Windows XP