sec_rgy_plcy_get_info-Returns the policy for an organization
#include <dce/policy.h> void sec_rgy_plcy_get_info( sec_rgy_handle_t context, sec_rgy_name_t organization, sec_rgy_plcy_t *policy_data, error_status_t *status);
An opaque handle bound to a registry server. Use sec_rgy_site_open() to acquire a bound handle.
A character string (type sec_rgy_name_t) containing the name of the organization for which the policy data is to be returned. If this string is empty, the routine returns the registry's policy data.
A pointer to the sec_rgy_plcy_t structure to receive the authentication policy. This structure contains the minimum length of a user's password, the lifetime of a password, the expiration date of a password, the lifetime of the entire account, and some flags describing limitations on the password spelling.
A pointer to the completion status. On successful completion, the routine returns error_status_ok. Otherwise, it returns an error.
The sec_rgy_plcy_get_info() routine returns the policy data for the specified organization. If no organization is specified, the registry's policy data is returned.
The policy data consists of the following:
- The password expiration date. This is the date on which account passwords will expire.
- The minimum length allowed for account passwords.
- The period of time (life span) for which account passwords will be valid.
- The period of time (life span) for which accounts will be valid.
- Flags indicating whether account passwords can consist entirely of spaces or entirely of alphanumeric characters.
Permissions RequiredThe sec_rgy_plcy_get_info() routine requires the r (read) permission on the policy object or organization from which the data is to be returned.
The returned policy may not be in effect if the overriding registry authorization policy is more restrictive. (See the sec_rgy_auth_plcy_get_effective() routine.)
The idl file from which dce/policy.h was derived.
The call was successful.
The registry server could not find the specified organization.
The DCE Registry Server is unavailable.