NAME

pkc_plcy_get_key_certifier_count — Returns number of a key’s certifying authorities

Synopsis

unsigned32 pkc_plcy_get_key_certifier_count(
gss_OID policy,
void ∗ keys_handle,
unsigned key_index,
size_t ∗ ca_count);

Parameters

Input

policySpecifies policy desired. 

keys_handle
A policy specific structure, obtained from a call to pkc_plcy_retrieve_keyinfo(3sec). 

key_indexSpecifies the key whose number of certifying authorities is to be returned. 

Output

ca_countNumber of certifying authorities for the key. 

Description

pkc_plcy_get_key_certifier_count(3sec) searches the list of registered policies for implementations of the specified policy. If found, the implementation is opened, if necessary, and its (∗get_key_certifier_count)() function is invoked. Necessary mutex protection around non-thread safe policy implementations is provided. 

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_plcy_intro(3sec), pkc_plcy_delete_keyinfo(3sec), pkc_plcy_delete_trustbase(3sec), pkc_plcy_establish_trustbase(3sec), pkc_plcy_get_key_certifier_info(3sec), pkc_plcy_get_key_count(3sec), pkc_plcy_get_key_data(3sec), pkc_plcy_get_key_trust(3sec), pkc_plcy_get_registered_policies(3sec), pkc_plcy_lookup_policy(3sec), pkc_plcy_retrieve_key(3sec), pkc_plcy_retrieve_keyinfo(3sec), pkc_register_policy(3sec).