sec_login_export_context-Export a login context.
#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 );
The login context whose advertisement is to be created.
The maximum length (in bytes) to be returned in 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.
Number of bytes of advertisement actually occupied by the advertisement of the login context.
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.
The completion status.
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).