NAME

pkc_lookup_element_in_trustlist — Retrieves a specified key

Synopsis

unsigned32 pkc_lookup_element_in_trustlist(
pkc_trust_list_t ∗ trust_list,
const pkc_trust_list_element_t  ∗∗ key,
unsigned long key_id);

Parameters

Input

trust_listSpecifies the trust list

key_idSpecifies ID of key to return. 

Output

keyA pointer to the returned key. 

Description

pkc_lookup_element_in_trustlist(3sec) takes a trust list and a key id, and returns a pointer to the specified key (if the key actually is in the trust list). 

This routine is a C++ interface. C++ must be used to perform direct certificate manipulation. 

See also the contents of the asn.h and x509.h header files, which define some of the basic types used by the low-level certificate manipulation routines. 

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_add_trusted_key(3sec), pkc_check_cert_against_trustlist(3sec), pkc_copy_trustlist(3sec), pkc_delete_trustlist(3sec), pkc_display_trustlist(3sec), pkc_lookup_key_in_trustlist(3sec), pkc_lookup_keys_in_trustlist(3sec), pkc_revoke_certificate(3sec), pkc_revoke_certificates(3sec).  Classes: pkc_ca_key_usage.class(3sec), pkc_constraints.class(3sec), pkc_generic_key_usage.class(3sec), pkc_key_policies.class(3sec), pkc_key_policy.class(3sec), pkc_key_usage.class(3sec), pkc_name_subord_constraint.class(3sec), pkc_name_subord_constraints.class(3sec), pkc_name_subtree_constraint.class(3sec), pkc_name_subtree_constraints.class(3sec), pkc_pending_revocation.class(3sec), pkc_revocation.class(3sec), pkc_revocation_list.class(3sec), pkc_trust_list.class(3sec), pkc_trust_list_element.class(3sec), pkc_trusted_key.class(3sec).