[#CMS_add1_recipient_cert]
= CMS_add1_recipient_cert
:mrdocs:

Add a KeyTransRecipientInfo for `recip` to a partial CMS enveloped ContentInfo.

== Synopsis

Declared in `<openssl/cms.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:CMS_RecipientInfo.adoc[CMS_RecipientInfo]*
CMS_add1_recipient_cert(
    xref:CMS_ContentInfo.adoc[CMS_ContentInfo]* cms,
    xref:X509.adoc[X509]* recip,
    unsigned int flags);
----

== Return Value

Internal pointer to the new CMS_RecipientInfo, or NULL on error.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *cms*
| Enveloped ContentInfo created with CMS_PARTIAL (for example via CMS_encrypt()).
| *recip*
| Recipient certificate whose public key wraps the content‐encryption key.
| *flags*
| Optional CMS flags such as CMS_USE_KEYID.
|===


[.small]#Created with https://www.mrdocs.com[MrDocs]#