SmimeSetEnvelopedCmsOnDecrypt Property

Namespace: MailBee.Security
Assembly: MailBee.NET (in MailBee.NET.dll) Version: 12.2.0 build 630 for .NET 4.5
public bool SetEnvelopedCmsOnDecrypt { get; set; }

Property Value

Type: Boolean
If true, MailBee will populate EnvelopedCmsResult property with EnvelopedCms object in SmimeResult object returned by methods capable of message signature verification in case if the message is encrypted. If false, EnvelopedCmsResult property will always remain a null reference (Nothing in Visual Basic). The default value is false.

In .NET Framework edition, instantiating EnvelopedCms object can be expensive operation so you should set this property to true only if you need the S/MIME message info which is not otherwise returned by other properties of SmimeResult class. Decrypt(MailMessage) methods do cause penalty while Decrypt2(MailMessage, X509Certificate2Collection) do not.

.NET Standard 2.0 edition, however, always operates through EnvelopedCms internally and there is no performance penalty in enabling this property there.

.NET Core 1.0/1.1 does not support EnvelopedCms and always operates through Win32 API. Therefore, SetEnvelopedCmsOnDecrypt has no effect there.

See Also