[#CMS_ReceiptRequest_create0]
= CMS_ReceiptRequest_create0
:mrdocs:

Allocate a CMS signed‐receipt request with the given identifiers and recipient lists.

== Synopsis

Declared in `<openssl/cms.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:CMS_ReceiptRequest.adoc[CMS_ReceiptRequest]*
CMS_ReceiptRequest_create0(
    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);
----

== 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*
| Non‐zero to request receipts from all or first‐tier recipients as encoded by CMS; see CMS_ReceiptRequest_create0(3).
| *receiptList*
| Stack of GeneralNames listing who should send receipts, or NULL.
| *receiptsTo*
| Stack of GeneralNames listing where receipts should be sent, or NULL.
|===


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