Certificates 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 the X509Certificate2Collection Class in the System.Security.Cryptography.X509Certificates namespace.]

The Certificates object represents a collection of Certificate objects. Each Certificate object represents a single digital certificate.

The Certificates object exposes the following interfaces:

When to use

The Certificates object is used to perform the following tasks:

Add or remove a Certificate object to or from the collection.
Generate a subset of the collection by finding a set of certificates or by displaying a dialog box to select the certificates.
Clear all the Certificate objects from the collection.
Retrieve the number of certificates in the collection.
Retrieve a specific Certificate object from the collection.
Iterate through the collection.

The Certificates object has these types of members:

The Certificates object has these methods.

Method	Description
Add	Adds a Certificate object to the collection. (Inherited from CertificatesICertificates2)
Clear	Removes all Certificate objects from the collection. (Inherited from CertificatesICertificates2)
Find	Returns a Certificates object that contains all certificates that match the specified search criteria. (Inherited from CertificatesICertificates2)
Remove	Removes a single Certificate object from the collection. (Inherited from CertificatesICertificates2)
Save	Saves the certificates to a specified file. (Inherited from CertificatesICertificates2)
Select	Displays a dialog box for selecting certificates and returns a collection of those certificates selected. (Inherited from CertificatesICertificates2)

The Certificates object has these properties.

Property	Access type	Description
_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	Read-only	Retrieves the number of Certificate objects in the collection.
Item	Read-only	Retrieves a Certificate object that represents the indexed certificate of the collection. This is the default property. (Inherited from CertificatesICertificates2ICertificates)

The Certificates object can be created, and it is safe for scripting. The ProgID for the Certificates object is "CAPICOM.Certificates.2".

CAPICOM 1.x: The ProgID for the Certificates object is "CAPICOM.Certificates.1".

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	Capicom.dll