This operation returns the reference bound to name relative to the context ctx.

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.

fn_ctx_lookup() sets status as described FN_status_t(3XFN) and xfn_status_codes(3XFN).

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 attributes(5) for descriptions of the following attributes:

FN_composite_name_t(3XFN), FN_ctx_t(3XFN), FN_ref_t(3XFN), FN_status_t(3XFN), fns_references(5), xfn_status_codes (3XFN), xfn(3XFN), attributes(5)