[#CMS_RecipientInfo_set0_password]
= CMS&lowbar;RecipientInfo&lowbar;set0&lowbar;password
:mrdocs:

Supply the password used to derive the KEK for a PasswordRecipientInfo&period;

== Synopsis

Declared in `&lt;openssl&sol;cms&period;h&gt;`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
CMS&lowbar;RecipientInfo&lowbar;set0&lowbar;password(
    xref:CMS_RecipientInfo.adoc[CMS&lowbar;RecipientInfo]* ri,
    unsigned char* pass,
    ssize&lowbar;t passlen);
----

== Return Value

1 on success, or 0 on failure&period;

== Parameters

[cols="1,4"]
|===
| Name| Description
| *ri*
| Recipient info of type CMS&lowbar;RECIPINFO&lowbar;PASS&period;
| *pass*
| Password bytes&semi; ownership transfers to `ri` (may be cleared on free)&period;
| *passlen*
| Length of `pass` in bytes, or &hyphen;1 if NUL&hyphen;terminated&period;
|===


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