NAME

fn_ctx_handle_from_ref − construct a handle to a context object using the given reference

SYNOPSIS

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

#include <xfn/xfn.h>

FN_ctx_t ∗fn_ctx_handle_from_ref(const FN_ref_t ∗ref, FN_status_t ∗status);

MT-LEVEL

Safe. 

DESCRIPTION

This operation creates a handle to an FN_ctx_t object using an FN_ref_t object for that context. 

RETURN VALUE

This operations returns a pointer to an FN_ctx_t object if the operation succeeds, otherwise, it returns a NULL pointer (0). 

ERRORS

fn_ctx_handle_from_ref() sets status as described in FN_status_t(3N) and xfn_status_codes(3N).  The following status code is of particular relevance to this operation. 

FN_E_NO_SUPPORTED_ADDRESS
A context object could not be constructed from a particular reference.  The reference contained no address type over which the context interface was supported.

SEE ALSO

FN_ctx_t(3N), FN_ref_t(3N), FN_status_t(3N), fn_ctx_handle_destroy(3N), fn_ctx_get_ref(3N), fns_references(5), xfn_status_codes(3N), xfn(3N)

SunOS 5.5  —  Last change: 4 Nov 1994