NAME

pkc_plcy_lookup_policy — Returns a policy module descriptor block

Synopsis

unsigned32 pkc_plcy_lookup_policy(
gss_OID oid,
pkc_policy_t ∗ details);

Parameters

Input

oidAn OID identifying a currently registered policy module. 

Output

detailsA 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_retrieve_key(3sec), pkc_plcy_retrieve_keyinfo(3sec), pkc_register_policy(3sec).