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 VALUE

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), fns_initial_context(5), fn_ctx_get_ref(3N), fn_ctx_handle_from_ref(3N), xfn_status_codes(3N), xfn(3N)

SunOS 5.5/SPARC  —  Last change: 4 Nov 1994