NAME

pkc_get_key_certifier_info — Returns information about a certifier

Synopsis

unsigned32 pkc_get_key_certifier_info(
keyinfo_t ∗ keyinfobase,
unsigned key_index,
unsigned certifier_index,
char ∗∗ certifier_name,
utc_t ∗ certification_start,
utc_t ∗ certification_expiration,
char ∗ crl_valid,
utc_t ∗ crl_last_seen,
utc_t ∗ next_crl_expected);

Parameters

Input

keyinfobaseInformation about the key (returned by pkc_retrieve_keyinfo(3sec)). 

key_indexIndex of the key. 

certifier_index
Index of the certifier about whom information is desired.

Output

certifier_name
The name of the certifier.

certification_start
Time at which certification by this certifier starts.

certification_expiration
Time at which certification by this certifier ends.

crl_validIf TRUE, there is a certificate revocation list for this certifier. 

crl_last_seen
Time at which certificate revocation list was last seen.

next_crl_expected
Time at which next certificate revocation list is expected.

Description

pkc_get_key_certifier_info(3sec) returns information about a specific certifier from a key’s certification path. Certifier 0 is the CA that vouched for the key; certifier 1 is the CA that vouched for certifier 0, etc. The total number of certifiers for a given key is returned by pkc_get_key_certifier_count(3sec). 

The desired information is extracted by the routine from the keyinfo_t structure, which must first be obtained by the caller by a call to the pkc_retrieve_keyinfo(3sec) routine. 

Any of the return parameters may be passed as NULL if the corresponding information is not required. 

Upon successful return, the certifier_name parameter will contain allocated storage which must be released with pkc_free(3sec) when the application has finished with it. 

Return Values

pkc_s_success
Operation successfully completed.

Errors

Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages. 

Related Information

Functions: pkc_intro(3sec), pkc_append_to_trustlist(3sec), pkc_free(3sec), pkc_free_keyinfo(3sec), pkc_free_trustbase(3sec), pkc_free_trustlist(3sec), pkc_get_key_certifier_count(3sec), pkc_get_key_count(3sec), pkc_get_key_data(3sec), pkc_get_key_trust_info(3sec), pkc_get_registered_policies(3sec), pkc_init_trustbase(3sec), pkc_init_trustlist(3sec), pkc_retrieve_keyinfo(3sec), pkc_retrieve_keylist(3sec).