[#CMS_ReceiptRequest_create0_ex]
= CMS_ReceiptRequest_create0_ex
:mrdocs:

Allocate a CMS signed‐receipt request using a library context for RNG.

== Synopsis

Declared in `<openssl/cms.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:CMS_ReceiptRequest.adoc[CMS_ReceiptRequest]*
CMS_ReceiptRequest_create0_ex(
    unsigned char* id,
    int idlen,
    int allorfirst,
    xref:stack_st_GENERAL_NAMES.adoc[stack_st_GENERAL_NAMES]* receiptList,
    xref:stack_st_GENERAL_NAMES.adoc[stack_st_GENERAL_NAMES]* receiptsTo,
    xref:OSSL_LIB_CTX.adoc[OSSL_LIB_CTX]* libctx);
----

== Return Value

New CMS_ReceiptRequest taking ownership of the stacks on success, or NULL on error.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *id*
| Receipt content identifier bytes, or NULL to generate a random id.
| *idlen*
| Length of `id` in bytes; ignored when `id` is NULL.
| *allorfirst*
| Value for receiptsFrom allOrFirstTier when `receiptList` is NULL.
| *receiptList*
| Stack of GeneralNames listing who should send receipts, or NULL.
| *receiptsTo*
| Stack of GeneralNames listing where receipts should be sent, or NULL.
| *libctx*
| Library context used to obtain the public random generator, or NULL.
|===


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