Enumerates the possible locations for certificates

Syntax

Visual Basic (Declaration)
Public Enum CertificateStoreLocation Inherits System.Enum

Visual Basic (Usage)	Copy Code
Dim instance As CertificateStoreLocation

C#
public enum CertificateStoreLocation : System.Enum

Managed Extensions for C++
__value public enum CertificateStoreLocation : public System.Enum

C++/CLI
public enum class CertificateStoreLocation : public System.Enum

Members

Member	Description
CurrentService	The current service’s certificates.
CurrentUser	The current user’s certificates.
CurrentUserGroupPolicy	Certificates for the current user’s groups
LocalMachine	The local machine’s certificates.
LocalMachineEnterprise	Certificates for the enterprise
LocalMachineGroupPolicy	Certificates for the local machine’s groups
Services	Certificates for services
Users	Certificates for users

Example

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

Visual Basic	Copy Code
Private Sub DisplayCertificateInfo(ByVal certNum as Integer) ' Create a new CertificateStore to access the "MY" certificate store Dim store as new CertificateStore(CertificateStoreLocation.LocalMachine, CertificateStoreName.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

Visual Basic

Copy Code

Private Sub DisplayCertificateInfo(ByVal certNum as Integer)
   
   ' Create a new CertificateStore to access the "MY" certificate store
   Dim store as new CertificateStore(CertificateStoreLocation.LocalMachine, CertificateStoreName.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 the "MY" certificate store CertificateStore store = new CertificateStore(CertificateStoreLocation.LocalMachine, CertificateStoreName.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); } }

Copy Code

private void DisplayCertificateInfo(int certNum)
{
   // Create a new CertificateStore to access the "MY" certificate store
   CertificateStore store = new CertificateStore(CertificateStoreLocation.LocalMachine, CertificateStoreName.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

The system store is the certificate store located in the HKEY_CURRENT_USER registry key. The machine store is the certificate store located in the HKEY_LOCAL_MACHINE registry key. Applications installed as a service should store their certificates in the machine store since there is no current user when running as a service.

Inheritance Hierarchy

System.Object
   System.ValueType
      System.Enum
         Dart.PowerTCP.Mail.CertificateStoreLocation

Requirements

Target Platforms: Microsoft .NET Framework 2.0