PreviousNext

pkc_lookup_element_in_trustlist(3sec)

Retrieves a specified key

Synopsis

#include <pkc_certs.h>

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_list
Specifies the trust list.

key_id
Specifies ID of key to return.

Output

key
A 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 is actually 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_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)