[#PKCS12_parse]
= PKCS12&lowbar;parse
:mrdocs:

Parse a PKCS&num;12 structure and extract key, certificate, and CA certificates&period;

== Synopsis

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

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
PKCS12&lowbar;parse(
    xref:PKCS12.adoc[PKCS12]* p12,
    char const* pass,
    xref:EVP_PKEY.adoc[EVP&lowbar;PKEY]** pkey,
    xref:X509.adoc[X509]** cert,
    stack&lowbar;st&lowbar;X509** ca);
----

== Return Value

1 on success, 0 on error&period;

== Parameters

[cols="1,4"]
|===
| Name| Description
| *p12*
| PKCS&num;12 structure to parse&period;
| *pass*
| Passphrase (UTF&hyphen;8, or ISO8859&hyphen;1 if not valid UTF&hyphen;8)&period;
| *pkey*
| Address of pointer to receive the private key, or NULL to discard&period;
| *cert*
| Address of pointer to receive the entity certificate, or NULL to discard&period;
| *ca*
| Address of stack pointer to receive additional certificates, or NULL to discard&period;
|===


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