X509VerificationFlags Enumeration

Note: This enumeration is new in the .NET Framework version 2.0.

Specifies conditions under which verification of certificates in the X509 chain should be conducted.

This enumeration has a FlagsAttribute attribute that allows a bitwise combination of its member values.

Namespace: System.Security.Cryptography.X509Certificates
Assembly: System (in system.dll)

public enum X509VerificationFlags
/** @attribute FlagsAttribute() */ 
public enum X509VerificationFlags
public enum X509VerificationFlags

 Member nameDescription
AllFlagsAll flags pertaining to verification are included. 
AllowUnknownCertificateAuthorityIgnore that the chain cannot be verified due to an unknown certificate authority (CA). 
IgnoreCertificateAuthorityRevocationUnknownIgnore that the certificate authority revocation is unknown when determining certificate verification. 
IgnoreCtlNotTimeValidIgnore that the certificate trust list (CTL) is not valid, for reasons such as the CTL has expired, when determining certificate verification. 
IgnoreCtlSignerRevocationUnknownIgnore that the certificate trust list (CTL) signer revocation is unknown when determining certificate verification. 
IgnoreEndRevocationUnknownIgnore that the end certificate (the user certificate) revocation is unknown when determining certificate verification. 
IgnoreInvalidBasicConstraintsIgnore that the basic constraints are not valid when determining certificate verification. 
IgnoreInvalidNameIgnore that the certificate has an invalid name when determining certificate verification. 
IgnoreInvalidPolicyIgnore that the certificate has invalid policy when determining certificate verification. 
IgnoreNotTimeNestedIgnore that the CA (certificate authority) certificate and the issued certificate have validity periods that are not nested when verifying the certificate. For example, the CA cert can be valid from January 1 to December 1 and the issued certificate from January 2 to December 2, which would mean the validity periods are not nested. 
IgnoreNotTimeValidIgnore certificates in the chain that are not valid either because they have expired or they are not yet in effect when determining certificate validity. 
IgnoreRootRevocationUnknownIgnore that the root revocation is unknown when determining certificate verification. 
IgnoreWrongUsageIgnore that the certificate was not issued for the current use when determining certificate verification. 
NoFlagNo flags pertaining to verification are included. 

These flags indicate the conditions under which chain verification should occur. For example, if an application does not require certificates time values in a chain to be valid, the IgnoreNotTimeValid flag can be used.

The following example opens the current user's personal certificate store, allows the user to select a certificate, then writes certificate and certificate chain information to the console. The output depends on the certificate you select.

//Output chain information of the selected certificate.
X509Chain ch = new X509Chain();
ch.Build (certificate);
Console.WriteLine ("Chain Information");
ch.ChainPolicy.RevocationMode = X509RevocationMode.Online;
Console.WriteLine ("Chain revocation flag: {0}", ch.ChainPolicy.RevocationFlag);
Console.WriteLine ("Chain revocation mode: {0}", ch.ChainPolicy.RevocationMode);
Console.WriteLine ("Chain verification flag: {0}", ch.ChainPolicy.VerificationFlags);
Console.WriteLine ("Chain verification time: {0}", ch.ChainPolicy.VerificationTime);
Console.WriteLine ("Chain status length: {0}", ch.ChainStatus.Length);
Console.WriteLine ("Chain application policy count: {0}", ch.ChainPolicy.ApplicationPolicy.Count);
Console.WriteLine ("Chain certificate policy count: {0} {1}", ch.ChainPolicy.CertificatePolicy.Count, Environment.NewLine);

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0

Community Additions