Previous section.

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

NAME

sec_login_refresh_identity-Refresh a login context

SYNOPSIS

#include <dce/sec_login.h>

boolean32 sec_login_refresh_identity (
    sec_login_handle_t login_context,
    error_status_t *status );

PARAMETERS

Input

login_context

Login context to be refreshed.

Output

status

The completion status.

DESCRIPTION

The sec_login_refresh_identity() routine refreshes a login context; that is, increases its expiration date to the maximum allowable (depending on local cell policy).

The refreshed login context reflects changes that may have been made to the principal/account's RS datastore information, but no other information associated with the login context will be modified (for example, any list of maximum group membership privilege set by sec_login_newgroups() remains in effect).

The refreshed login context is unvalidated, so it must be validated (with sec_login_validate_identity()) before it is usable.

It is an error to refresh a locally-authenticated context.

ERRORS

error_status_ok

sec_login_s_context_invalid

sec_login_s_default_use

sec_login_s_internal_error

sec_login_s_refresh_ident_bad

sec_rgy_object_not_found

sec_rgy_server_unavailable

SEE ALSO

Functions: sec_login_get_expiration().
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