| ## pkc_get_key_certifier_info(3sec) Returns information about a certifier Synopsis #include <pkc_certs.h> 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 keyinfobase Information about the key (returned by pkc_retrieve_keyinfo(3sec)). key_index Index 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_valid If 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) ##