fn_ctx_get_ref(3XFN)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | APPLICATION USAGE | ATTRIBUTES | SEE ALSO | NOTES

NAME

fn_ctx_get_ref– return a context's reference

SYNOPSIS

cc [ flag ... ] file ... -lxfn [ library ... ]
#include <xfn/xfn.h>

FN_ref_t *fn_ctx_get_ref(const FN_ctx_t *ctx, FN_status_t *status);

DESCRIPTION

This operation returns a reference to the supplied context object.

RETURN VALUE

fn_ctx_get_ref() returns a pointer to an FN_ref_t object if the operation succeeds, it returns 0 if the operation fails.

ERRORS

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

FN_E_OPERATION_NOT_SUPPORTED

Using the fn_ctx_get_ref() operation on the Initial Context returns this status code.

APPLICATION USAGE

fn_ctx_get_ref() cannot be used on the Initial Context. fn_ctx_get_ref() can be used on contexts bound in the Initial Context (in other words, the bindings in the Initial Context have references).

If the context handle was created earlier using the fn_ctx_handle_from_ref() operation, the reference returned by the fn_ctx_get_ref() operation may not necessarily be exactly the same in content as that originally supplied. For example, fn_ctx_handle_from_ref() may construct the context handle from one address from the list of addresses. The context implementation may return with a call to fn_ctx_get_ref() only that address, or a more complete list of addresses than what was supplied in fn_ctx_handle_from_ref( ).

ATTRIBUTES

See attributes (5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
MT-Level	Safe.

SEE ALSO

FN_ctx_t(3XFN), FN_ref_t(3XFN), FN_status_t(3XFN), fn_ctx_handle_from_initial(3XFN), fn_ctx_handle_from_ref(3XFN), xfn_status_codes (3XFN), xfn(3XFN), attributes(5)

NOTES

The Federated Naming Service based on the X/Open XFN standard might not be supported in a future release of the Solaris operating system.

SunOS 5.9  Last Revised 16 Oct 2003

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | APPLICATION USAGE | ATTRIBUTES | SEE ALSO | NOTES