| ## sec_login_inquire_net_info(3sec) Returns a principal's network information Synopsis #include <dce/sec_login.h> void sec_login_inquire_net_info( sec_login_handle_t login_context, sec_login_net_info_t *net_info, error_status_t *status); Parameters Input login_context An opaque handle to the login context for the desired principal. (See sec_intro(3sec) for more details about the login context.) Output net_info A pointer to the returned sec_login_net_info_t data structure that contains the principal's network information. The sec_login_net_info_t structure is defined as follows: typedef struct { sec_id_pac_t pac; unsigned32 acct_expiration_date; unsigned32 passwd_expiration_date; unsigned32 identity_expiration_date; } sec_login_net_info_t; }; status A pointer to the completion status. Description The sec_login_inquire_net_info( ) routine returns network information for the principal identified by the specified login context. The network information consists of the following: · The Privilege Attribute Certificate (PAC) that describes the identity and group memberships of the principal. · The expiration date for the principal's account in the DCE Registry. · The expiration date for the principal's password in the DCE Registry. · The lifetime for the principal's authenticated network identity. This is the lifetime of the principal's TGT (see the sec_login_get_expiration( ) routine). A value of 0 (zero) for an expiration date means there is no expiration date. In other words, the principal's account, password, or authenticated identity is good indefinitely. To remove the returned net_info structure when it is no longer needed, use sec_login_free_net_info( ). Files /usr/include/dce/sec_login.idl The idl file from which dce/sec_login.h was derived. Errors The following describes a partial list of errors that might be returned. Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages. sec_login_s_not_certified The login context is not certified. sec_login_s_context_invalid The login context is not valid. sec_login_s_no_current_context The default context was specified, but none exists. sec_login_s_auth_local Operation not valid on local context. The call's identity was not authenticated. error_status_ok The call was successful. Related Information Functions: sec_intro(3sec) sec_login_get_expiration(3sec) sec_login_free_net_info(3sec) ##