VMS Help DCE_SECURITY, API Routines, sec_rgy_cell_bind  *Conan The Librarian (sorry for the slow response - running on an old VAX)

 NAME
   sec_rgy_cell_bind - Binds to a registry in a cell

 SYNOPSIS

   #include <dce/binding.h>

   void sec_rgy_cell_bind(
           unsigned_char_t *cell_name,
           sec_rgy_bind_auth_info_t *auth_info,
           sec_rgy_handle_t *context,
           error_status_t *status);

 PARAMETERS

   Input

   cell_name
          A character string (type unsigned_char_t) containing the name
          of the cell in question. Upon return, a Security Server for
          that cell is associated with context, the registry server
          handle. The cell must be specified completely and precisely.
          This routine offers none of the pathname resolving services
          of sec_rgy_site_bind().

   auth_info
          A pointer to the sec_rgy_bind_auth_info_t structure that
          identifies the authentication protocol, protection level,
          and authorization protocol to use in establishing the
          binding.  (See the rpc_binding_set_auth_info() routine).

   Output

   context
          A pointer to a sec_rgy_handle_t variable. Upon return, this
          contains a registry server handle indicating ("bound to")
          the desired registry site.

   status
          A pointer to the completion status.  On successful completion,
          the routine returns error_status_ok. Otherwise, it returns an
          error.

 DESCRIPTION

   The sec_rgy_cell_bind() routine establishes a relationship with a
   registry site at an arbitrary level of security. The cell_name
   parameter identifies the target cell.

 FILES
     SYS$COMMON:[DCE$LIBRARY]BINDING.IDL
                The idl file from which dce/binding.h was derived.

 ERRORS

   sec_rgy_server_unavailable
                The DCE Registry Server is unavailable.

   error_status_ok
                The call was successful.

 RELATED INFORMATION

   Functions: sec_intro
              sec_rgy_site_bind