[#OSSL_PARAM_get_utf8_string]
= OSSL&lowbar;PARAM&lowbar;get&lowbar;utf8&lowbar;string
:mrdocs:

Copy a UTF&hyphen;8 string OSSL&lowbar;PARAM into a caller&hyphen;provided or allocated buffer&period;

== Synopsis

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

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
OSSL&lowbar;PARAM&lowbar;get&lowbar;utf8&lowbar;string(
    xref:OSSL_PARAM.adoc[OSSL&lowbar;PARAM] const* p,
    char** val,
    size&lowbar;t max&lowbar;len);
----

== Return Value

1 on success, or 0 on failure&period;

== Parameters

[cols="1,4"]
|===
| Name| Description
| *p*
| Parameter of type OSSL&lowbar;PARAM&lowbar;UTF8&lowbar;STRING&period;
| *val*
| When &ast;`val` is NULL, receives a newly allocated copy&semi; otherwise writes into the buffer of size `max&lowbar;len&period;`
| *max&lowbar;len*
| Capacity of &ast;`val` when non&hyphen;NULL (including space for the NUL)&semi; ignored when allocating&period;
|===


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