Message.SenderCertificate Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets or sets the security certificate used to authenticate messages.
public:
property cli::array <System::Byte> ^ SenderCertificate { cli::array <System::Byte> ^ get(); void set(cli::array <System::Byte> ^ value); };[System.Messaging.MessagingDescription("MsgSenderCertificate")]
public byte[] SenderCertificate { get; set; }[<System.Messaging.MessagingDescription("MsgSenderCertificate")>]
member this.SenderCertificate : byte[] with get, setPublic Property SenderCertificate As Byte()Property Value
An array of byte values that represents a security certificate, which Message Queuing uses to verify the sender of the message. The default is a zero-length array.
- Attributes
Exceptions
The message queue is filtered to ignore the SenderCertificate property.
Remarks
The receiving application uses the SenderCertificate property when the message includes an external security certificate.
Message Queuing can authenticate a message using either an internal or external security certificate. Message Queuing provides internal certificates, which are used to verify message integrity. A certification authority provides an external certificate, which you can access through the SenderCertificate property of the message. In addition to allowing Message Queuing to authenticate the message, an external certificate allows the receiving application to further verify the sender. An internal certificate has no usable value to a receiving application.
An external certificate must be registered with the directory service of the Message Queuing system. An external certificate contains information about the certification authority, the certificate user, the validity period of the certificate, the public key of the certificate user, and the certification authority's signature.
