NAME

fn_ctx_handle_from_initial − return a handle to the Initial Context

SYNOPSIS

cc [ flag ... ] file ... −lxfn [ library ... ]

#include <xfn/xfn.h>

FN_ctx_t ∗fn_ctx_handle_from_initial(FN_status_t ∗status);

MT-LEVEL

MT-Safe

DESCRIPTION

This operation returns a handle to the caller’s Initial Context.  On successful return, the handle points to a context which meets the specification of the XFN Initial Context (see fns_initial_context(5)). 

RETURN VALUES

fn_ctx_handle_from_initial() returns a pointer to an FN_ctx_t object if the operation succeeds; it returns a NULL pointer (0) otherwise. 

ERRORS

fn_ctx_handle_from_initial() sets only the status code portion of the status object status.

SEE ALSO

FN_ctx_t(3N), FN_status_t(3N), fn_ctx_get_ref(3N), fn_ctx_handle_from_ref(3N), xfn(3N), xfn_status_codes(3N), fns_initial_context(5)

NOTES

The implementation of XFN in this Solaris release is based on the X/Open preliminary specification.  It is likely that there will be minor changes to these interfaces to reflect changes in the final version of this specification.  The next minor release of Solaris will offer binary compatibility for applications developed using the current interfaces.  As the interfaces evolve toward standardization, it is possible that future releases of Solaris will require minor source code changes to applications that have been developed against the preliminary specification. 

SunOS 5.5.1  —  Last change: 4 Nov 1994