NAME

sec_login_export_context-Export a login context.

SYNOPSIS

#include <dce/sec_login.h>

void sec_login_export_context (
    sec_login_handle_t login_context,
    unsigned32 count_max,
    idl_byte_t advertisement[],
    unsigned32 *count,
    unsigned32 *count_needed,
    error_status_t *status );

PARAMETERS

Input

login_context

The login context whose advertisement is to be created.

count_max

The maximum length (in bytes) to be returned in advertisement.

Input/Output

advertisement[]

Buffer (which is opaque; that is, whose structure and contents are implementation-dependent), of length at least count_max, to hold the advertisement of the login context.

Output

count

Number of bytes of advertisement actually occupied by the advertisement of the login context.

count_needed

If count_max is less than the length (in bytes) of the advertisement of the login context, the sec_login_s_no_memory status value is returned, and count_needed indicates the length of the advertisement.

status

The completion status.

DESCRIPTION

The sec_login_export_context() routine exports a login context; that is, creates an advertisement for it. Such an advertisement consists of information that can be communicated to other processes and enables them to (potentially) share the login context. Such sharing is restricted to processes on the local host. The advertisement can be communicated to other processes (on the local host) by any means desired by the communicating processes (it need not be a trusted communication path).

In typical implementations, the advertisement of a login context is simply the name of the login context's cache file (which is protected by local host security).

ERRORS

error_status_ok

sec_login_s_no_memory

sec_login_s_handle_invalid

sec_login_s_internal_error

sec_login_s_context_invalid

SEE ALSO

Functions: sec_login_import_context().