[#CMS_RecipientInfo_set0_password]
= CMS_RecipientInfo_set0_password
:mrdocs:

Supply the password used to derive the KEK for a PasswordRecipientInfo.

== Synopsis

Declared in `<openssl/cms.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
CMS_RecipientInfo_set0_password(
    xref:CMS_RecipientInfo.adoc[CMS_RecipientInfo]* ri,
    unsigned char* pass,
    ssize_t passlen);
----

== Return Value

1 on success, or 0 on failure.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *ri*
| Recipient info of type CMS_RECIPINFO_PASS.
| *pass*
| Password bytes; ownership transfers to `ri` (may be cleared on free).
| *passlen*
| Length of `pass` in bytes, or ‐1 if NUL‐terminated.
|===


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