Previous section.

DCE 1.1: Authentication and Security Services
Copyright © 1997 The Open Group

NAME

sec_login_get_expiration-Retrieve the expiration date of a login context.

SYNOPSIS

#include <dce/sec_login.h>

void sec_login_get_expiration (
    sec_login_handle_t login_context,
    unsigned32 *expiration_date,
    error_status_t *status );

PARAMETERS

Input

login_context

Login context whose expiration date is to be retrieved.

Output

expiration_date

The expiration date of the login context (measured in seconds from midnight January 1, 1970 UTC).

status

The completion status.

DESCRIPTION

The sec_login_get_expiration() routine retrieves the expiration_date of a (validated) login context, which is the date beyond which RPC binding handles annotated with the login context (in the sense of rpc_binding_set_auth_info() in the referenced Open Group DCE 1.1 RPC Specification) will fail. (The RPC failure may occur at either RPC invocation time or at RPC return time, since both are authenticated-this fact is especially interesting in the case of long-lived RPC operations.)

ERRORS

error_status_ok

sec_login_s_context_invalid

sec_login_s_default_use

sec_login_s_internal_error

sec_login_s_no_current_context

sec_login_s_not_certified

SEE ALSO

Functions: sec_login_refresh_identity().
Please note that the html version of this specification may contain formatting aberrations. The definitive version is available as an electronic publication on CD-ROM from The Open Group.

Contents Next section Index