IX509CertificateRequestPkcs10::get_SmimeCapabilities method (certenroll.h)

Article
07/27/2022

The SmimeCapabilities property specifies or retrieves a Boolean value that tells the Encode method whether to create an IX509ExtensionSmimeCapabilities collection that identifies the encryption capabilities supported by the computer. This property is web enabled for both input and output.

This property is read/write.

Syntax

HRESULT get_SmimeCapabilities(
  VARIANT_BOOL *pValue
);

Parameters

pValue

Return value

None

Remarks

Multipurpose Internet Mail Extensions (MIME) is a specification for formatting binary data into text so that it can be sent in email. Secure/Multipurpose Internet Mail Extensions (S/MIME) is a standard for encrypting and signing a MIME message.

The SmimeCapabilities extension, represented by an IX509ExtensionSmimeCapabilities object, is used when sending and receiving encrypted email messages to report the recipient's decryption capabilities to the sender. This enables the sender to choose the most secure algorithm supported by both the sender and recipient.

If you did not set the SuppressDefaults property before calling the Encode method, the SmimeCapabilities extension is added by default and the available symmetric algorithm OIDs are enumerated and added to the extension value. Set the SmimeCapabilities property before calling Encode.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Target Platform	Windows
Header	certenroll.h
DLL	CertEnroll.dll