sec_login_release_context(3sec)
Frees storage allocated for a login context
Synopsis
#include <dce/sec_login.h>
void sec_login_release_context(
sec_login_handle_t *login_context,
error_status_t *status);
Parameters
Input/Output
login_context
A pointer to an opaque handle to login context data. The login context contains, among other data, the account principal name and UUID, account restrictions,
records of group membership, and the process home directory. (See sec_intro(3sec) for more details about the login context.)
Output
status
A pointer to the completion status. On successful completion, the routine returns error_status_ok. Otherwise, it returns an error.
Description
The sec_login_release_context( ) routine frees any memory allocated for a login context. Unlike sec_login_purge_context( ), it does not destroy
the associated network credentials that still reside in the credential cache.
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_default_use
Illegal use of the default login handle occurred.
sec_login_s_context_invalid
The login context itself is invalid.
error_status_ok
The call was successful.
Related Information
Functions: