MessageCertificateX509 Class

Article
12/30/2016

Base class that encapsulates X509 certificates for messages.

Namespace: Microsoft.ConfigurationManagement.Messaging.Framework
Assembly: Microsoft.ConfigurationManagement.Messaging (in Microsoft.ConfigurationManagement.Messaging.dll)

Inheritance Hierarchy

System.Object
Microsoft.ConfigurationManagement.Messaging.Framework.MessageCertificate
Microsoft.ConfigurationManagement.Messaging.Framework.MessageCertificateX509
Microsoft.ConfigurationManagement.Messaging.Framework.MessageCertificateX509File
Microsoft.ConfigurationManagement.Messaging.Framework.MessageCertificateX509Volatile

Syntax

[SerializableAttribute]
public abstract class MessageCertificateX509 : MessageCertificate, 
    IDisposable, ISerializable, IDeserializationCallback

[SerializableAttribute]
public ref class MessageCertificateX509 abstract : MessageCertificate, 
    IDisposable, ISerializable, IDeserializationCallback

<SerializableAttribute>
Public MustInherit Class MessageCertificateX509
    Inherits MessageCertificate
    Implements IDisposable, ISerializable, IDeserializationCallback

Properties

	Name	Description
	CertificateEncoded	Gets the complete certificate in blob format.
	HasDisposed	True if the certificate object has been disposed; otherwise, false.
	HashAlgorithmName	Gets the hash algorithm name in a format that can be used by .NET cryptography.
	HashAlgorithmOid	Gets the virtual hash algorithm name in a format that can be used for signing and hashing of messages by using the Crypto API.
	IsDeserialized	If true, the certificate has been deserialized from a binary formatter. At this time, some data is lost when serialization occurs, which allows throwing clear exceptions indicating this.
	IsSelfSigned	Gets a value that indicates whether the certificate is self-signed or issued by a certificate authority (CA).
	IsVolatile	If true, the certificate is volatile and stored in memory. If false, the certificate is stored in a certificate store and can be used globally.
	PrivateKeyCsp	Gets the Cryptographic Service Provider (CSP) for the private key.
	PublicKey	Gets the public key for a certificate. (Overrides MessageCertificate.PublicKey.)
	PublicKeyEncoded	Gets the public key blob for a certificate. (Overrides MessageCertificate.PublicKeyEncoded.)
	RawCertificate	Represents the raw certificate (including the private key) in raw format.
	StoreLocation	Gets or sets the store location. Returns null if the store location is not supported.
	StoreName	Gets or sets the name of the store. Returns null if the store name is not supported.
	Synchronizer	Gets the synchronization object to use for locking across threads. (Inherited from MessageCertificate.)
	Thumbprint	Gets the certificate thumbprint for use in cryptographic operations.
	UseLegacyHashing	If true, legacy hashing should be used. This implies that algorithms should not be specified, depending on the implementation of the message or sender.
	X509Certificate	Gets the certificate that is specified by Certificate.

Methods

	Name	Description
	CreateAndStoreSelfSignedCertificate(String, String, String, StoreLocation, String[], DateTime, DateTime)	Creates a self-signed certificate and stores it in the certificate store.
	CreateSelfSignedCertificate(String, String, String[], DateTime, DateTime)	Creates a self-signed certificate.
	Dispose()	Dispose of any unmanaged resources.
	Dispose(Boolean)	Dispose of any unmanaged resources.
	Encrypt(Byte[])	Encrypts data. (Overrides MessageCertificate.Encrypt(Byte[]).)
	Encrypt(Byte[], X509Certificate2[])	Encrypts data.
	Encrypt(String)	Encrypts data using the certificate. (Inherited from MessageCertificate.)
	Equals(Object)	(Inherited from Object.)
	Finalize()	(Inherited from Object.)
	GetHashCode()	(Inherited from Object.)
	GetObjectData(SerializationInfo, StreamingContext)	Handles Message Certificate X.509 serialization.
	GetPublicKey()	Gets the public key for a certificate.
	GetType()	(Inherited from Object.)
	Hash(Byte[])	Hashes data by using a HashAlgorithm algorithm.
	Hash(Byte[], String)	Hashes data using a HashAlgorithm algorithm.
	HashAlgorithmOidToAlgId(String)	Converts an OID to an AlgID.
	HashAlgorithmToAlgId(String)	Converts a hash algorithm string representation to an algorithm ID recognized by WinCrypt.
	HashAlgorithmToOid(String)	Converts a hash algorithm to its OID representation.
	HashAndSign(Byte[], MessageCertificateSigningOptions)	Hashes data, and then signs the hash.
	HashAndSign(String, Encoding, MessageCertificateSigningOptions)	Hashes data, and then signs the hash.
	HashAndSign(String, MessageCertificateSigningOptions)	Hashes data, and then signs the hash.
	MemberwiseClone()	(Inherited from Object.)
	OnDeserialization(Object)	Deserialization handler.
	Sign(Byte[])	Signs data by using a certificate. (Overrides MessageCertificate.Sign(Byte[]).)
	Sign(Byte[], String)	Signs data by using a certificate.
	Sign(String)	Signs data using the certificate. (Inherited from MessageCertificate.)
	Sign(String, Encoding)	Signs data by using a certificate. (Overrides MessageCertificate.Sign(String, Encoding).)
	ToString()	(Inherited from Object.)
	VerifyPkcsSignature(Byte[], Byte[])	Performs a Public Key Cryptography Standards (PKCS) signature verification of a blob.
	VerifySignature(Byte[], Byte[])	Verifies the signature by using the certificate specified in the properties. Note: The byte signature is reversed to support interop in native C++ byte signing. (Overrides MessageCertificate.VerifySignature(Byte[], Byte[]).)
	VerifySignature(Byte[], Byte[], String)	Verifies the signature by using the certificate specified in the properties. Note: The byte signature is reversed to support interop in native C++ byte signing.
	VerifySignature(Byte[], String)	Verifies a signature by using the certificate. (Inherited from MessageCertificate.)
	VerifySignature(Byte[], String, Encoding)	Verifies a signature by using the certificate. (Inherited from MessageCertificate.)

Thread Safety

Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Share via