hx509 certificate store functions(3) | Heimdalx509library | hx509 certificate store functions(3) |
NAME
hx509 certificate store functions -Functions
int hx509_certs_init (hx509_context context, const char *name, int flags, hx509_lock lock, hx509_certs *certs)
Detailed Description
See the Certificate store operations for description and examples.Function Documentation
int hx509_certs_add (hx509_context context, hx509_certs certs, hx509_cert cert)
Add a certificate to the certificiate store.The receiving keyset certs will either increase reference counter of the cert or make a deep copy, either way, the caller needs to free the cert itself.
Parameters:
Returns:
int hx509_certs_append (hx509_context context, hx509_certs to, hx509_lock lock, const char * name)
Same a hx509_certs_merge() but use a lock and name to describe the from source.Parameters:
Returns:
int hx509_certs_end_seq (hx509_context context, hx509_certs certs, hx509_cursor cursor)
End the iteration over certificates.Parameters:
Returns:
int hx509_certs_filter (hx509_context context, hx509_certs certs, const hx509_query * q, hx509_certs * result)
Filter certificate matching the query.Parameters:
Returns:
Return HX509_CERT_NOT_FOUND if no certificate in certs matched the query.
int hx509_certs_find (hx509_context context, hx509_certs certs, const hx509_query * q, hx509_cert * r)
Find a certificate matching the query.Parameters:
Returns:
Return HX509_CERT_NOT_FOUND if no certificate in certs matched the query.
void hx509_certs_free (hx509_certs * certs)
Free a certificate store.Parameters:
int hx509_certs_info (hx509_context context, hx509_certs certs, int(*)(void *, const char *) func, void * ctx)
Print some info about the certificate store.Parameters:
Returns:
int hx509_certs_init (hx509_context context, const char * name, int flags, hx509_lock lock, hx509_certs * certs)
Open or creates a new hx509 certificate store.Parameters:
- •
- HX509_CERTS_CREATE create a new keystore of the specific TYPE.
- •
- HX509_CERTS_UNPROTECT_ALL fails if any private key failed to be extracted.
lock a lock that unlocks the certificates store, use NULL to select no password/certifictes/prompt lock (see Locking and unlocking certificates and encrypted data.).
certs return pointer, free with hx509_certs_free().
int hx509_certs_iter_f (hx509_context context, hx509_certs certs, int(*)(hx509_context, void *, hx509_cert) func, void * ctx)
Iterate over all certificates in a keystore and call an function for each fo them.Parameters:
Returns:
int hx509_certs_merge (hx509_context context, hx509_certs to, hx509_certs from)
Merge a certificate store into another. The from store is keep intact.Parameters:
Returns:
int hx509_certs_next_cert (hx509_context context, hx509_certs certs, hx509_cursor cursor, hx509_cert * cert)
Get next ceritificate from the certificate keystore pointed out by cursor.Parameters:
Returns:
int hx509_certs_start_seq (hx509_context context, hx509_certs certs, hx509_cursor * cursor)
Start the integrationParameters:
Returns:
int hx509_certs_store (hx509_context context, hx509_certs certs, int flags, hx509_lock lock)
Write the certificate store to stable storage.Parameters:
Returns:
int hx509_ci_print_names (hx509_context context, void * ctx, hx509_cert c)
Iterate over all certificates in a keystore and call an function for each fo them.Parameters:
Returns:
Parameters:
Returns:
int hx509_get_one_cert (hx509_context context, hx509_certs certs, hx509_cert * c)
Get one random certificate from the certificate store.Parameters:
Returns:
11 Jan 2012 | Version 1.5.2 |