[ новости /+++ | форум | теги | ]

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 Ini-
     tial 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 con-
     text   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  attri-
     butes:



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

Партнёры:

Хостинг: