CertificateStore Class

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

For a list of all members of this type, see CertificateStore members.

Object Model

Inheritance Hierarchy

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

Syntax

[Visual Basic]
<DefaultMemberAttribute("Item")>
Public Class CertificateStore 
   Inherits ArrayList

[C#]
[DefaultMemberAttribute("Item")]
public class CertificateStore : ArrayList

[C++]
[DefaultMemberAttribute("Item")]
public __gc class CertificateStore : public ArrayList

[C++/CLI]
[DefaultMemberAttribute("Item")]
public ref class CertificateStore : public ArrayList

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.

Example

The following example demonstrates accessing a certificate and displaying info about it.

[Visual Basic]

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#]



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);

  }

}

Requirements

Namespace: Dart.PowerTCP.SslSockets

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

Assembly: Dart.PowerTCP.SslSockets (in Dart.PowerTCP.SslSockets.dll)

See Also

Requirements

Language

CertificateStore Class

Object Model

Inheritance Hierarchy

Syntax

Remarks

Example

Requirements

See Also