sec_rgy_login_get_effective-Returns the effective login data for an account
#include <dce/misc.h> void sec_rgy_login_get_effective( sec_rgy_handle_t context, sec_rgy_login_name_t *login_name, sec_rgy_acct_key_t *key_parts, sec_rgy_sid_t *sid, sec_rgy_unix_sid_t *unix_sid, sec_rgy_acct_user_t *user_part, sec_rgy_acct_admin_t *admin_part, sec_rgy_plcy_t *policy_data, signed32 max_number, signed32 *supplied_number, uuid_t id_projlist, signed32 unix_projlist, signed32 *num_projects, sec_rgy_name_t cell_name, uuid_t *cell_uuid, sec_override_fields_t *overridden, error_status_t *status);
The registry server handle.
The maximum number of projects to be returned by the call. This must be no larger than the allocated size of the projlist arrays.
A pointer to the account login name. A login name is composed of the names for the account's principal, group, and organization (PGO) items.
A pointer to the minimum abbreviation allowed when logging in to the account. Abbreviations are not currently implemented and the only legal value is sec_rgy_acct_key_person.
A pointer to a sec_rgy_sid_t structure to receive the returned Subject Identifier (SID) for the account. This structure consists of the UUIDs for the account's PGO items.
A pointer to a sec_rgy_unix_sid_t structure to receive the returned UNIX Subject Identifier (SID) for the account. This structure consists of the UNIX numbers for the account's PGO items.
A pointer to a sec_rgy_acct_user_t structure to receive the returned user data for the account.
A pointer to a sec_rgy_acct_admin_t structure to receive the returned administrative data for the account.
A pointer to a sec_rgy_policy_t structure to receive the policy data for the account. The policy data is associated with the account's organization, as identified in the login name.
A pointer to the actual number of projects returned. This will always be less than or equal to the max_number supplied on input.
An array to receive the UUID of each project returned. The size allocated for the array is given by max_number. If this value is less than the total number of projects in the account project list, multiple calls must be made to return all of the projects.
An array to receive the UNIX number of each project returned. The size allocated for the array is given by max_number. If this value is less than the total number of projects in the account project list, multiple calls must be made to return all of the projects.
A pointer indicating the total number of projects in the specified account's project list.
The name of the account's cell.
The UUID for the account's cell.
A pointer to a 32-bit set of flags identifying the local overrides, if any, for the account login information.
A pointer to the completion status. On successful completion, the routine returns error_status_ok. Otherwise, it returns an error.
The sec_rgy_login_get_effective() routine returns effective login information for the specified account. Login information is extracted from the account's entry in the registry database. Effective login information is a combination of the login information from the registry database and any login overrides defined for the account on the local machine.
The overridden parameter indicates which, if any, of the following local overrides have been defined for the account:
- The UNIX user ID
- The group ID
- The encrypted password
- The account's miscellaneous information (gecos) field
- The account's home directory
- The account's login shell
Local overrides for account login information are defined in the /etc/passwd_override file and apply only to the local machine.
The idl file from which dce/misc.h was derived.
The file that defines local overrides for account login information.
The call was successful.
The specified account could not be found.
The DCE Registry Server is unavailable.