[#EVP_PKEY_get_utf8_string_param]
= EVP_PKEY_get_utf8_string_param
:mrdocs:

Read a UTF‐8 string parameter from a key by OSSL_PKEY_PARAM name.

== Synopsis

Declared in `<openssl/evp.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
EVP_PKEY_get_utf8_string_param(
    xref:EVP_PKEY.adoc[EVP_PKEY] const* pkey,
    char const* key_name,
    char* str,
    size_t max_buf_sz,
    size_t* out_sz);
----

== Return Value

1 on success, or 0 on failure.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *pkey*
| Key to query.
| *key_name*
| Parameter name such as OSSL_PKEY_PARAM_GROUP_NAME.
| *str*
| Output buffer for the NUL‐terminated string, or NULL to query size only.
| *max_buf_sz*
| Capacity of `str` in bytes.
| *out_sz*
| Optional pointer receiving the required/written length including NUL.
|===


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