sec_rgy_unix_getpwuid-Returns a UNIX-style password structure for the account matching the specified UUID
#include <dce/rgynbase.h>
void sec_rgy_unix_getpwuid(
sec_rgy_handle_t context,
signed32 uid,
sec_rgy_cursor_t *item_cursor,
sec_rgy_unix_passwd_t *passwd_entry,
error_status_t *status);
Input
- context
An opaque handle bound to a registry server. Use sec_rgy_site_open() to acquire a bound handle.
- uid
A 32-bit integer UNIX ID.
Input/Output
- item_cursor
An opaque pointer indicating a specific PGO item entry in the registry database. The sec_rgy_unix_getpwuid() routine returns the PGO item indicated by item_cursor, and advances the cursor to point to the next item in the database. When the end of the list of entries is reached, the routine returns sec_rgy_no_more_entries. Use sec_rgy_cursor_reset() to refresh the cursor.
Output
- passwd_entry
A UNIX style password structure returned with information about the account matching uid.
- status
On successful completion, the routine returns error_status_ok. Otherwise, it returns an error.
The sec_rgy_unix_getpwuid() routine looks up the next password entry in the registry that matches the input UNIX ID and returns the corresponding sec_rgy_unix_passwd_t structure. The structure is in the following form:The structure includes:typedef struct { sec_rgy_unix_login_name_t name; sec_rgy_unix_passwd_buf_t passwd; signed32 Vuid; signed32 Vgid; signed32 oid sec_rgy_unix_gecos_t gecos; sec_rgy_pname_t homedir; sec_rgy_pname_t shell; } sec_rgy_unix_passwd_t;
- The account's login name.
- The account's password.
- The account's UNIX ID.
- The UNIX ID of group and organization associated with the account.
- The account's GECOS information.
- The account's home directory.
- The account's login shell
This call is provided in source code form.
- /usr/include/dce/rgynbase.idl
The idl file from which dce/rgynbase.h was derived.
- error_status_ok
The call was successful.
- sec_rgy_no_more_entries
The end of the list of entries has been reached.
- sec_rgy_server_unavailable
The DCE Registry Server is unavailable.
Contents | Next section | Index |