PreviousNext

pkc_plcy_register_policy(3sec)

Registers a policy module

Synopsis

#include <dce/pkc_base.h>

#include <dce/pkc_plcy_reg.h>

unsigned32 pkc_plcy_register_policy(

pkc_policy_t * plcy,

int replacement_policy);

Parameters

Input

plcy
A pointer to the policy module structure to be registered.

replacement_policy
Specifies how the registration is to be handled if an implementation of the policy is already registered. There are three possible values:
PKC_REPLACE_NONE
Specifies that an error should be returned if an implementation of the policy is already registered.
PKC_REPLACE_ENTRYPOINTS
Specifies that only entrypoints that the original implementation (if any) did not provide should be replaced. (Note that this value is not currently supported.)
PKC_REPLACE_ALL
Specifies that the new implementation should replace the existing one, if any.

Description

pkc_plcy_register_policy(3sec) registers a policy module, in the form of a properly declared pkc_policy_t data structure, which contains identifying information about the module as well as entry points to all of the module's functions.

Calling this routine will cause the module passed to it to be registered among the system's policy modules; it can then be accessed by other applications via the high level certification routines.

C++ must be used to perform policy registration.

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_plcy_intro(3sec)
pkc_plcy_delete_keyinfo(3sec)
pkc_plcy_delete_trustbase(3sec)
pkc_plcy_establish_trustbase(3sec)
pkc_plcy_get_key_certifier_count(3sec)
pkc_plcy_get_key_certifier_info(3sec)
pkc_plcy_get_key_count(3sec)
pkc_plcy_get_key_data(3sec)
pkc_plcy_get_key_trust(3sec)
pkc_plcy_get_registered_policies(3sec)
pkc_plcy_lookup_policy(3sec)
pkc_plcy_retrieve_keyinfo(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)