sec_login_import_context(3sec)

Synopsis

#include <dce/sec_login.h>

void sec_login_import_context(
unsigned32 buf_len,
idl_byte buf[ ],
sec_login_handle_t *login_context,
error_status_t *status);

Parameters

Input

buf_len
The allocated length (in bytes) of the buffer containing the login context.

buf[ ]
An idl_byte array containing the importable login context.

Output

login_context
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.)

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_import_context( ) routine imports a context obtained via a call to sec_login_export_context( ) performed on the same machine.

To import a login context, users must have the appropriate privileges. Non-privileged users can import only their own login context; privileged users can import the login contexts created by any users.

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_context_invalid
The login context itself is not valid.

sec_login_s_default_use
Illegal use of the default login handle occurred.

error_status_ok
The call was successful.

Related Information
Functions:

sec_intro(3sec)

sec_login_export_context(3sec)