fn_ctx_lookup(3N)
NAME
fn_ctx_lookup − look up name in context
SYNOPSIS
cc [ flag ... ] file ... −lxfn [ library ... ]
#include <xfn/xfn.h>
FN_ref_t ∗fn_ctx_lookup(FN_ctx_t ∗ctx, const FN_composite_name_t ∗name,
FN_status_t ∗status);
DESCRIPTION
This operation returns the reference bound to name relative to the context ctx.
RETURN VALUE
If the operation succeeds, the fn_ctx_lookup() function returns a handle to the reference bound to name. Otherwise, 0 is returned and status is set appropriately.
ERRORS
fn_ctx_lookup() sets status as described FN_status_t(3N) and xfn_status_codes(3N).
APPLICATION USAGE
Some naming services may not always have reference information for all names in their contexts; for such names, such naming services may return a special reference whose type indicates that the name is not bound to any address. This reference may be name service specific or it may be the conventional NULL reference defined in the X/Open registry. See fns_references(5).
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
| MT-Level | Safe. |
SEE ALSO
FN_composite_name_t(3N), FN_ctx_t(3N), FN_ref_t(3N), FN_status_t(3N), fns_references(5), xfn_status_codes(3N), xfn(3N), attributes(5)
SunOS 5.6 — Last change: 30 Dec 1996