[CAPICOM is a 32-bit only component that is available for use in the following operating systems: Windows Server 2008, Windows Vista, Windows XP, and Windows 2000. Instead, use Platform Invocation Services (PInvoke) to call the Win32 API functions CryptEncryptMessage and CryptDecryptMessage to encrypt and decrypt messages. For information about PInvoke, see Platform Invoke Tutorial. The .NET and CryptoAPI via P/Invoke: Part 1 and .NET and CryptoAPI via P/Invoke: Part 2 subsections of Extending .NET Cryptography with CAPICOM and P/Invoke may also be helpful.]
Applies to: desktop apps only
The EncryptedData object provides properties and methods to encrypt and decrypt data using a session key derived from a secret.
Note CAPICOM does not support the PKCS #7 EncryptedData content type but uses a nonstandard ASN structure for EncryptedData. Therefore, only CAPICOM can decrypt a CAPICOM EncryptedData object.
Members
The EncryptedData object has these types of members:
Methods
The EncryptedData object has these methods.
| Method | Description |
|---|
|
Decrypt
|
Decrypts encrypted content using the secret.
|
|
Encrypt
|
Encrypts the content using the current secret and encryption algorithm.
|
|
SetSecret
|
Sets the secret from which the encryption/decryption session key is derived.
|
Properties
The EncryptedData object has these properties.
| Property | Access type | Description |
|---|
|
Algorithm
| Read-only |
Algorithm used for encryption/decryption.
|
|
Content
| Read/write |
The content to be encrypted or decrypted. Setting this property must be done before the Encrypt
method is called.
When the value of this property is reset, directly or indirectly, the whole state of the object is reset, and any encrypted content in the object is lost.
This is the default property.
|
Remarks
The EncryptedData object can be created, and it is safe for scripting. The ProgID for the EncryptedData object is CAPICOM.EncryptedData.1.
Requirements
|
End of client support
| Windows Vista |
|---|
|
End of server support
| Windows Server 2008 |
|---|
|
Redistributable
| CAPICOM 2.0 or later on
Windows Server 2003, Windows XP, Windows 2000 Server with SP3 and later, and Windows 2000 Professional with SP3 and later |
|---|
|
DLL
|
- Capicom.dll
|
|---|
See also
-
Cryptography Objects
Send comments about this topic to Microsoft
Build date: 3/6/2012