pkc_init_trustlist(3sec)

Synopsis

#include <pkc_api.h>

unsigned32 pkc_init_trustlist(

trustlist_t ** tr_list);

Parameters

Input

tr_list
A PKC-allocated data structure which contains the initialized trust list.

Description

pkc_init_trustlist(3sec) creates an empty trust list. If tr_list is empty, returns pkc_s_asn_bad_param; if memory cannot be allocated, returns pkc_s_nomem; otherwise, returns pkc_s_success.

Upon successful return, tr_list will contain a PKC-allocated data structure which must be released with pkc_free_trustlist(3sec) when the application has finished with it.

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_count(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_retrieve_keyinfo(3sec)
pkc_retrieve_keylist(3sec)