Previous section.

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

NAME

sec_login_purge_context-Purge a login context

SYNOPSIS

#include <dce/sec_login.h>

void sec_login_purge_context (
    sec_login_handle_t *login_context,
    error_status_t *status );

PARAMETERS

Input

login_context

Login context to be purged.

Output

status

The completion status.

DESCRIPTION

The sec_login_purge_context() routine purges a login context; that is, unregisters it in the sense of making it inaccessible to the calling process and to other processes on the local host.

In typical implementations, this routine frees local memory storage in the current address space allocated to the specified login context, and deletes the login context's on-disk cache file (first overwriting its contents with NULL bytes (that is, all bits reset to 0), to limit its exposure to compromise). (The login context remains accessible to those processes that had previously stored it in their address spaces, however.)

ERRORS

error_status_ok

sec_login_s_context_invalid

sec_login_s_default_use

SEE ALSO

Functions: sec_login_set_context(), sec_login_release_context().
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