EncryptedData object
[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 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.]
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
| Requirement | Value |
|---|---|
| End of client support |
Windows Vista |
| End of server support |
Windows Server 2008 |
| Redistributable |
CAPICOM 2.0 or later on Windows Server 2003 and Windows XP |
| DLL |
|
See also