NAME

pkc_get_key_certifier_count — Returns number of key’s certifying authorities

Synopsis

unsigned32 pkc_get_key_certifier_count(
keyinfo_t  ∗ keyinfobase,
unsigned key_index,
size_t ∗ ca_count);

Parameters

Input

keyinfobaseA keyinfo_t structure containing information about the key. 

key_indexThe index of the key (ranging from 0 to key_count - 1). 

Output

ca_countNumber of certifying authorities for the key. 

Description

pkc_get_key_certifier_count(3sec) returns the number of certifying authorities in the certification path of the specified key. 

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. 

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_info(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).