Export (0) Print
Expand All

Recipients object

[The Recipients object is available for use in the operating systems specified in the Requirements section. Instead, use the CmsRecipientCollection Class in the System.Security.Cryptography.Pkcs namespace.]

The Recipients object represents a collection of Certificate objects. Each object represents an intended recipient of the enveloped message. Data in an EnvelopedData object is encrypted with a symmetric session key, and that symmetric session key is then itself encrypted for each recipient by using the public key from that intended recipient's certificate. A recipient with access to the private key associated with a certificate's public key can decrypt the session key and use the decrypted session key to decrypt the actual data.

When to use

The Recipients object is used to perform the following tasks:

  • Add or remove a Certificate object from the collection.
  • Retrieve the number of certificates in the collection.
  • Retrieve a specific Recipients object from the collection.
  • Iterate through the collection.

Members

The Recipients object has these types of members:

Methods

The Recipients object has these methods.

MethodDescription
Add

Adds a Certificate object to the collection.

Clear

Removes all Certificate objects from the collection.

Remove

Removes a Certificate object from the collection.

 

Properties

The Recipients object has these properties.

PropertyAccess typeDescription

_NewEnum

Read-only

Retrieves an IEnumVARIANT interface on an object that can be used to enumerate the collection. This property is hidden within Visual Basic Scripting Edition (VBScript).

Count

The number of objects in the Recipients collection.

Item

An indexed object in the collection. This is the default property.

 

Remarks

The Recipients object cannot be created.

Requirements

Redistributable

CAPICOM 2.0 or later on Windows Server 2003 and Windows XP

DLL

Capicom.dll

See also

Cryptography Objects

 

 

Community Additions

ADD
Show:
© 2014 Microsoft