NAME

pkc_retrieve_keylist — Retrieves all keys for a principal

Synopsis

unsigned32 pkc_retrieve_keylist(
trustbase_t ∗ base,
char ∗ name,
trusted_key_t ∗∗ out_keys,
size_t ∗ no_of_keys);

Parameters

Input

baseSpecifies trust base from which to retrieve keys. 

nameSpecifies principal whose keys are to be retrieved. 

Output

out_keysKeys retrieved. 

no_of_keys
Number of keys retrieved.

Description

Given an initialized trust base, pkc_retrieve_keylist(3sec) returns all public keys for the principal specified. 

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_init_trustlist(3sec), pkc_retrieve_keyinfo(3sec).