System::Security::Cryptography::X509Certificates Namespace Reference

Namespaces
	Details

Classes
class	PublicKey
	Represents a X509-certificate's public key information. Objects of this class should only be allocated using System::MakeObject() function. Never create instance of this type on stack or using operator new, as it will result in runtime errors and/or assertion faults. Always wrap this class into System::SmartPtr pointer and use this pointer to pass it to functions as argument. More...
class	X500DistinguishedName
	Represents distinguished name of X509 certificate. Objects of this class should only be allocated using System::MakeObject() function. Never create instance of this type on stack or using operator new, as it will result in runtime errors and/or assertion faults. Always wrap this class into System::SmartPtr pointer and use this pointer to pass it to functions as argument. More...
class	X509Certificate
	X.509 v.3 certificate. Encrypted certificates are not supported. Only X509KeyStorageFlags::DefaultKeySet flag is supported. Objects of this class should only be allocated using System::MakeObject() function. Never create instance of this type on stack or using operator new, as it will result in runtime errors and/or assertion faults. Always wrap this class into System::SmartPtr pointer and use this pointer to pass it to functions as argument. More...
class	X509Certificate2
	Represents X509 certificate. Objects of this class should only be allocated using System::MakeObject() function. Never create instance of this type on stack or using operator new, as it will result in runtime errors and/or assertion faults. Always wrap this class into System::SmartPtr pointer and use this pointer to pass it to functions as argument. More...
class	X509Certificate2Collection
	Collection of X509 certificate objects. Objects of this class should only be allocated using System::MakeObject() function. Never create instance of this type on stack or using operator new, as it will result in runtime errors and/or assertion faults. Always wrap this class into System::SmartPtr pointer and use this pointer to pass it to functions as argument. More...
class	X509Certificate2CollectionPtr
	Pointer to collection of X509 certificates. This type is a pointer to manage other object's deletion. It should be allocated on stack and passed to functions either by value or by const reference. More...
class	X509CertificateCollection
	Collection of X509 certificate objects. Objects of this class should only be allocated using System::MakeObject() function. Never create instance of this type on stack or using operator new, as it will result in runtime errors and/or assertion faults. Always wrap this class into System::SmartPtr pointer and use this pointer to pass it to functions as argument. More...
class	X509CertificateCollectionPtr
	Pointer to collection of X509 certificates. This type is a pointer to manage other object's deletion. It should be allocated on stack and passed to functions either by value or by const reference. More...
class	X509Chain
	Represents the X509 certificate chain. Objects of this class should only be allocated using System::MakeObject() function. Never create instance of this type on stack or using operator new, as it will result in runtime errors and/or assertion faults. Always wrap this class into System::SmartPtr pointer and use this pointer to pass it to functions as argument. More...
class	X509ChainPolicy
	The chain policy that will be applied when building an X509 certificate chain. Objects of this class should only be allocated using System::MakeObject() function. Never create instance of this type on stack or using operator new, as it will result in runtime errors and/or assertion faults. Always wrap this class into System::SmartPtr pointer and use this pointer to pass it to functions as argument. More...
class	X509ChainStatus
	Stores the X509 chain status and error information. Objects of this class should only be allocated using System::MakeObject() function. Never create instance of this type on stack or using operator new, as it will result in runtime errors and/or assertion faults. Always wrap this class into System::SmartPtr pointer and use this pointer to pass it to functions as argument. More...
class	X509Extension
	Extension object to keep extra information associated with X.509 certificate. Objects of this class should only be allocated using System::MakeObject() function. Never create instance of this type on stack or using operator new, as it will result in runtime errors and/or assertion faults. Always wrap this class into System::SmartPtr pointer and use this pointer to pass it to functions as argument. More...
class	X509ExtensionCollection
	Collection of extension objects. Objects of this class should only be allocated using System::MakeObject() function. Never create instance of this type on stack or using operator new, as it will result in runtime errors and/or assertion faults. Always wrap this class into System::SmartPtr pointer and use this pointer to pass it to functions as argument. More...
class	X509ExtensionEnumerator
	Enumerator to iterate through extension collection. Objects of this class should only be allocated using System::MakeObject() function. Never create instance of this type on stack or using operator new, as it will result in runtime errors and/or assertion faults. Always wrap this class into System::SmartPtr pointer and use this pointer to pass it to functions as argument. More...
class	X509ExtensionCollectionPtr
	Pointer to collection of X509 extensions. This type is a pointer to manage other object's deletion. It should be allocated on stack and passed to functions either by value or by const reference. More...
class	X509KeyUsageExtension
	Extension object to keep extra information about the usage of a key. Objects of this class should only be allocated using System::MakeObject() function. Never create instance of this type on stack or using operator new, as it will result in runtime errors and/or assertion faults. Always wrap this class into System::SmartPtr pointer and use this pointer to pass it to functions as argument. More...

Enumerations
enum class	X500DistinguishedNameFlags {   None = 0 , Reversed = 1 , UseSemicolons = 16 , DoNotUsePlusSign = 32 ,   DoNotUseQuotes = 64 , UseCommas = 128 , UseNewLines = 256 , UseUTF8Encoding = 4096 ,   UseT61Encoding = 8192 , ForceUTF8Encoding = 16384 }
	X509 certificate distinguished name formatting rules. More...
enum class	X509ChainStatusFlags {   NoError = 0x00000000 , NotTimeValid = 0x00000001 , NotTimeNested = 0x00000002 , Revoked = 0x00000004 ,   NotSignatureValid = 0x00000008 , NotValidForUsage = 0x00000010 , UntrustedRoot = 0x00000020 , RevocationStatusUnknown = 0x00000040 ,   Cyclic = 0x00000080 , InvalidExtension = 0x00000100 , InvalidPolicyConstraints = 0x00000200 , InvalidBasicConstraints = 0x00000400 ,   InvalidNameConstraints = 0x00000800 , HasNotSupportedNameConstraint = 0x00001000 , HasNotDefinedNameConstraint = 0x00002000 , HasNotPermittedNameConstraint = 0x00004000 ,   HasExcludedNameConstraint = 0x00008000 , PartialChain = 0x00010000 , CtlNotTimeValid = 0x00020000 , CtlNotSignatureValid = 0x00040000 ,   CtlNotValidForUsage = 0x00080000 , OfflineRevocation = 0x01000000 , NoIssuanceChainPolicy = 0x02000000 , ExplicitDistrust = 0x04000000 ,   HasNotSupportedCriticalExtension = 0x08000000 , HasWeakSignature = 0x00100000 }
enum class	X509ContentType {   Unknown = 0 , Cert = 1 , SerializedCert = 2 , Pkcs12 = 3 ,   Pfx = 3 , SerializedStore = 4 , Pkcs7 = 5 , Authenticode = 6 }
	Format of X.509 certificate. More...
enum class	X509IncludeOption { None = 0 , ExcludeRoot = 1 , EndCertOnly = 2 , WholeChain = 3 }
	Specifies what certificates in chain to include. More...
enum class	X509KeyStorageFlags : int32_t {   DefaultKeySet = 0 , UserKeySet = 1 , MachineKeySet = 2 , Exportable = 4 ,   UserProtected = 8 , PersistKeySet = 16 }
	Defines how to store key. More...
enum class	X509KeyUsageFlags : int32_t {   None = 0x0000 , EncipherOnly = 0x0001 , CrlSign = 0x0002 , KeyCertSign = 0x0004 ,   KeyAgreement = 0x0008 , DataEncipherment = 0x0010 , KeyEncipherment = 0x0020 , NonRepudiation = 0x0040 ,   DigitalSignature = 0x0080 , DecipherOnly = 0x8000 }
	Defines how the certificate key can be used. More...
enum class	X509NameType {   SimpleName = 0 , EmailName = 1 , UpnName = 2 , DnsName = 3 ,   DnsFromAlternativeName = 4 , UrlName = 5 }
	Type of X.509 certificate-contained name which relates to either issuer or subject of the certificate. More...
enum class	X509RevocationFlag { EndCertificateOnly = 0 , EntireChain = 1 , ExcludeRoot = 2 }
enum class	X509VerificationFlags {   NoFlag = 0x00000000 , IgnoreNotTimeValid = 0x00000001 , IgnoreCtlNotTimeValid = 0x00000002 , IgnoreNotTimeNested = 0x00000004 ,   IgnoreInvalidBasicConstraints = 0x00000008 , AllowUnknownCertificateAuthority = 0x00000010 , IgnoreWrongUsage = 0x00000020 , IgnoreInvalidName = 0x00000040 ,   IgnoreInvalidPolicy = 0x00000080 , IgnoreEndRevocationUnknown = 0x00000100 , IgnoreCtlSignerRevocationUnknown = 0x00000200 , IgnoreCertificateAuthorityRevocationUnknown = 0x00000400 ,   IgnoreRootRevocationUnknown = 0x00000800 , AllFlags = 0x00000FFF }

Functions
	DECLARE_ENUM_OPERATORS (System::Security::Cryptography::X509Certificates::X500DistinguishedNameFlags)
	Declaration of template arithmetic operators for values of the X500DistinguishedNameFlags enum type. More...
	DECLARE_ENUM_OPERATORS (System::Security::Cryptography::X509Certificates::X509ChainStatusFlags)
	DECLARE_ENUM_OPERATORS (System::Security::Cryptography::X509Certificates::X509KeyStorageFlags)
	Declaration of template arithmetic operators for values of the X509KeyStorageFlags enum type. More...
	DECLARE_ENUM_OPERATORS (System::Security::Cryptography::X509Certificates::X509KeyUsageFlags)
	Declaration of template arithmetic operators for values of the X509KeyUsageFlags enum type. More...
	DECLARE_ENUM_OPERATORS (System::Security::Cryptography::X509Certificates::X509VerificationFlags)

Enumeration Type Documentation

X500DistinguishedNameFlags

enum System::Security::Cryptography::X509Certificates::X500DistinguishedNameFlags

strong

X509 certificate distinguished name formatting rules.

Enumerator
None	No special characteristics.
Reversed	Name is reserved.
UseSemicolons	Use semicolons.
DoNotUsePlusSign	Name doesn't use plus sign.
DoNotUseQuotes	Disables quotes in name.
UseCommas	Enables using commas.
UseNewLines	Enables using new lines.
UseUTF8Encoding	Switches from using Unicode to using UTF-8 encoding.
UseT61Encoding	Switches to T61 encoding.
ForceUTF8Encoding	Forces using UTF-8 when encoding specific X500 keys.

X509ChainStatusFlags

enum System::Security::Cryptography::X509Certificates::X509ChainStatusFlags

strong

Enumerator
NoError
NotTimeValid
NotTimeNested
Revoked
NotSignatureValid
NotValidForUsage
UntrustedRoot
RevocationStatusUnknown
Cyclic
InvalidExtension
InvalidPolicyConstraints
InvalidBasicConstraints
InvalidNameConstraints
HasNotSupportedNameConstraint
HasNotDefinedNameConstraint
HasNotPermittedNameConstraint
HasExcludedNameConstraint
PartialChain
CtlNotTimeValid
CtlNotSignatureValid
CtlNotValidForUsage
OfflineRevocation
NoIssuanceChainPolicy
ExplicitDistrust
HasNotSupportedCriticalExtension
HasWeakSignature

X509ContentType

enum System::Security::Cryptography::X509Certificates::X509ContentType

strong

Format of X.509 certificate.

Enumerator
Unknown	Unknown certificate.
Cert	Single certificate.
SerializedCert	Serialized single certificate.
Pkcs12	PKCS #12-formatted certificate.
Pfx	PFX-formatted certificate.
SerializedStore	Serialized cerificate store.
Pkcs7	Serfificated PKCS #7-formatted certificate.
Authenticode	Authenticode X.509 certificate.

X509IncludeOption

enum System::Security::Cryptography::X509Certificates::X509IncludeOption

strong

Specifies what certificates in chain to include.

Enumerator
None	Chain information only.
ExcludeRoot	Whole chain excluding root certificate.
EndCertOnly	Whole chain excluding end certificate.
WholeChain	Whole chain.

X509KeyStorageFlags

enum System::Security::Cryptography::X509Certificates::X509KeyStorageFlags : int32_t

strong

Defines how to store key.

Enumerator
DefaultKeySet	Use default key set.
UserKeySet	Use user-associated store instead of machine-local one.
MachineKeySet	Use local machine store instead of user one.
Exportable	Marks imported keys as exportable.
UserProtected	Notify user that the key is being used.
PersistKeySet	The key is persisted when importing certificate.

X509KeyUsageFlags

enum System::Security::Cryptography::X509Certificates::X509KeyUsageFlags : int32_t

strong

Defines how the certificate key can be used.

Enumerator
None	No key usage parameters.
EncipherOnly	Key can be used only for encryption.
CrlSign	Key can be used to sign a certificate revocation list.
KeyCertSign	Key can be used to sign certificates.
KeyAgreement	Key can be used to determine key agreement.
DataEncipherment	Key can be used for data encryption.
KeyEncipherment	Key can be used for key encryption.
NonRepudiation	Key can be used for authentication.
DigitalSignature	Key can be used as a digital signature.
DecipherOnly	Key can be used only for decryption.

X509NameType

enum System::Security::Cryptography::X509Certificates::X509NameType

strong

Type of X.509 certificate-contained name which relates to either issuer or subject of the certificate.

Enumerator
SimpleName	Simple name of subject or issuer.
EmailName	Email address.
UpnName	UPN name.
DnsName	DNS name.
DnsFromAlternativeName	Alternative DNS name equivalent to DNS name.
UrlName	URL.

X509RevocationFlag

enum System::Security::Cryptography::X509Certificates::X509RevocationFlag

strong

Enumerator
EndCertificateOnly
EntireChain
ExcludeRoot

X509VerificationFlags

enum System::Security::Cryptography::X509Certificates::X509VerificationFlags

strong

Enumerator
NoFlag
IgnoreNotTimeValid
IgnoreCtlNotTimeValid
IgnoreNotTimeNested
IgnoreInvalidBasicConstraints
AllowUnknownCertificateAuthority
IgnoreWrongUsage
IgnoreInvalidName
IgnoreInvalidPolicy
IgnoreEndRevocationUnknown
IgnoreCtlSignerRevocationUnknown
IgnoreCertificateAuthorityRevocationUnknown
IgnoreRootRevocationUnknown
AllFlags

Function Documentation

DECLARE_ENUM_OPERATORS() [1/5]

System::Security::Cryptography::X509Certificates::DECLARE_ENUM_OPERATORS

(

System::Security::Cryptography::X509Certificates::X500DistinguishedNameFlags

)

Declaration of template arithmetic operators for values of the X500DistinguishedNameFlags enum type.

DECLARE_ENUM_OPERATORS() [2/5]

System::Security::Cryptography::X509Certificates::DECLARE_ENUM_OPERATORS

(

System::Security::Cryptography::X509Certificates::X509ChainStatusFlags

)

DECLARE_ENUM_OPERATORS() [3/5]

System::Security::Cryptography::X509Certificates::DECLARE_ENUM_OPERATORS

(

System::Security::Cryptography::X509Certificates::X509KeyStorageFlags

)

Declaration of template arithmetic operators for values of the X509KeyStorageFlags enum type.

DECLARE_ENUM_OPERATORS() [4/5]

System::Security::Cryptography::X509Certificates::DECLARE_ENUM_OPERATORS

(

System::Security::Cryptography::X509Certificates::X509KeyUsageFlags

)

Declaration of template arithmetic operators for values of the X509KeyUsageFlags enum type.

DECLARE_ENUM_OPERATORS() [5/5]

System::Security::Cryptography::X509Certificates::DECLARE_ENUM_OPERATORS

(

System::Security::Cryptography::X509Certificates::X509VerificationFlags

)