PreviousNext

pkc_retrieve_keylist(3sec)

Retrieves all keys for a principal

Synopsis

#include <pkc_certs.h>

unsigned32 pkc_retrieve_keylist(

trustbase_t * base,

char * name,

trusted_key_t ** out_keys,

size_t * no_of_keys);

Parameters

Input

base
Specifies trust base from which to retrieve keys.

name
Specifies principal whose keys are to be retrieved.

Output

out_keys
Keys 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_keylist(3sec)