NAME

sec_login_inquire_net_info — Returns a principal’s network information

Synopsis

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_infoA 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;
};

statusA 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_free_net_info(3sec), sec_login_get_expiration(3sec).