[#PKCS5_pbe_set0_algor_ex]
= PKCS5_pbe_set0_algor_ex
:mrdocs:

Set a PBES1 AlgorithmIdentifier (OID, iteration count, and salt) with a library context.

== Synopsis

Declared in `<openssl/x509.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
PKCS5_pbe_set0_algor_ex(
    xref:X509_ALGOR.adoc[X509_ALGOR]* algor,
    int alg,
    int iter,
    unsigned char const* salt,
    int saltlen,
    xref:OSSL_LIB_CTX.adoc[OSSL_LIB_CTX]* libctx);
----

== Return Value

1 on success, or 0 on failure.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *algor*
| Destination AlgorithmIdentifier updated in place.
| *alg*
| PBE algorithm NID.
| *iter*
| Iteration count for key derivation.
| *salt*
| Salt octets, or NULL to generate a random salt of length `saltlen` (or a default when `saltlen` is 0).
| *saltlen*
| Length of `salt` in bytes, or the length of salt to generate when `salt` is NULL.
| *libctx*
| Library context for random salt generation, or NULL for the default.
|===


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