PreviousNext

pkc_plcy_lookup_policy(3sec)

Returns a policy module descriptor block

Synopsis

#include <dce/pkc_base.h>

#include <dce/pkc_plcy_reg.h>

unsigned32 pkc_plcy_lookup_policy(

gss_OID oid,

pkc_policy_t * details);

Parameters

Input

oid
An OID identifying a currently registered policy module.

Output

details
A pointer to a policy module descriptor block.

Description

pkc_plcy_lookup_policy(3sec) returns a policy module descriptor block for the specified policy, and leaves the policy list unlocked. Calling this routine is the preferred way of obtaining information about a registered policy implementation.

The complete list of registered policies may be obtained by calling pkc_get_registered_policies(3sec).

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_register_policy(3sec)
pkc_plcy_retrieve_keyinfo(3sec)