PowerTCP Mail for .NET
CertificateStore Class
Members  Example  See Also  Send comments on this topic.
Dart.PowerTCP.Mail Namespace : CertificateStore Class




Use the CertificateStore Object to gain access to a store of certificates on the local system.

Object Model

CertificateStore ClassCertificate Class

Syntax

Visual Basic (Declaration) 
<DefaultMemberAttribute("Item")>
Public Class CertificateStore 
   Inherits System.Collections.ArrayList
Visual Basic (Usage)Copy Code
Dim instance As CertificateStore
C# 
[DefaultMemberAttribute("Item")]
public class CertificateStore : System.Collections.ArrayList 
Managed Extensions for C++ 
[DefaultMemberAttribute("Item")]
public __gc class CertificateStore : public System.Collections.ArrayList 
C++/CLI 
[DefaultMemberAttribute("Item")]
public ref class CertificateStore : public System.Collections.ArrayList 

Example

The following example demonstrates accessing a certificate and displaying info about it.
Visual BasicCopy Code
Private Sub DisplayCertificateInfo(ByVal certNum as Integer)
   
   ' Create a new CertificateStore to access certificates
   Dim store as new CertificateStore(CertificateStoreLocation.LocalMachine, CertificateStore.My)

   Try
      ' Get the requested certificate
      Dim cert as Certificate = store(certNum)

      ' Display info about the certificate
      Dim msg as String
      msg+= "The following information about the certificate is available." + vbCrLF + vbCrLf
      msg+= "Name: " + cert.Name + vbCrLf 
      msg+= "Description: " + cert.Description + vbCrLf
      msg+= "Expires: " + cert.ExpirationDate + vbCrLf
      msg+= "Issued: " + cert.IssueDate + vbCrLf
      msg+= "Issues to: " + cert.IssuedTo + vbCrLf
      msg+= "Serial number: " + cert.SerialNumber + vbCrLf
      msg+= "Version: " + cert.Versio
      MessageBox.Show(msg)
   Catch ex as Exception
      MessageBox.Show("Error. No certificate found at index " + certNum)
   End Try
End Sub
C#Copy Code
private void DisplayCertificateInfo(int certNum)
{
   // Create a new CertificateStore to access certificates
   CertificateStore store = new CertificateStore(CertificateStoreLocation.LocalMachine, CertificateStore.My);

   try
   {
      // Get the requested certificate
      Certificate cert = store[certNum];

      // Display info about the certificate
      string msg = "";
      msg+= "The following information about the certificate is available.\r\n\r\n";
      msg+= "Name: " + cert.Name + "\r\n";
      msg+= "Description: " + cert.Description + "\r\n";
      msg+= "Expires: " + cert.ExpirationDate + "\r\n";
      msg+= "Issued: " + cert.IssueDate + "\r\n";
      msg+= "Issues to: " + cert.IssuedTo + "\r\n";
      msg+= "Serial number: " + cert.SerialNumber + "\r\n";
      msg+= "Version: " + cert.Version;
      MessageBox.Show(msg);
   }
   catch(Exception ex)
   {
      MessageBox.Show("Error. No certificate found at index " + certNum);
   }
}

Remarks

A certificate store is a permanent storage location where certificates, certificate revocation lists, and certificate trust lists are stored. Use this object by creating a new instance of CertificateStore, passing in the certificate store location, certificate store name, and key usage filter. This will create the CertificateStore object (which actually is a collection of Certificate objects which meet the criteria specified). Iterate through this collection to access each Certificate object.

The CertificateListForm control, included with this product, provides a convenient utility for managing local security certificates.

Inheritance Hierarchy

System.Object
   System.Collections.ArrayList
      Dart.PowerTCP.Mail.CertificateStore

Requirements

Target Platforms: Microsoft .NET Framework 2.0

See Also

Documentation Version 3.2
© 2010 Dart Communications. All Rights Reserved.