pkc_plcy_get_key_certifier_info(3sec)

Synopsis

#include <pkc_certs.h>

unsigned32 pkc_plcy_get_key_certifier_info(

gss_OID policy,

void * keys_handle,

unsigned key_index,

unsigned ca_index,

char ** certifier_name,

utc_t * certification_start,

utc_t * certification_expiration,

char * is_crl_valid,

utc_t * last_crl_seen,

utc_t * next_crl_expected);

Parameters

Input

policy
The policy desired.

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

key_index
Index of the key.

ca_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.

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

last_crl_seen
Time at which certificate revocation list was last seen.

next_crl_expected
Time at which next certificate revocation list is expected.

Description

pkc_plcy_get_key_certifier_info(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_info)( ) 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_count(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_register_policy(3sec)
pkc_plcy_retrieve_keyinfo(3sec)