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_login_get_expiration(3sec)