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);

MT-LEVEL

Safe. 

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). 

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)

SunOS 5.5  —  Last change: 4 Nov 1994