sec_login_export_context(3sec)

Synopsis

#include <dce/sec_login.h>

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

Parameters

Input

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

buf_len
An unsigned 32-bit integer containing the allocated length (in bytes) of the buffer that is to contain the login context.

Output

buf[ ]
An idl_byte array that contains the exportable login context upon return.

len_used
A pointer to an unsigned 32-bit integer indicating the number of bytes needed for the entire login context, up to buf_len.

len_needed
If the allocated length of the buffer is too short, an error is issued (sec_login_s_no_memory), and on return this pointer indicates the number of bytes necessary to contain 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_export_context( ) routine obtains an exportable version of the login context information. This information may be passed to another process running on the same machine.

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_no_memory
Not enough space was allocated for the buf[ ] array. The len_needed parameter will point to the needed length.

sec_login_s_handle_invalid
The login context handle is invalid.

sec_login_s_context_invalid
The login context specified by the input handle is invalid.

Related Information
Functions:

sec_intro(3sec)

sec_login_import_context(3sec)