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

 NAME
   sec_rgy_site_open_update - Binds to a registry update site

 SYNOPSIS

   #include <dce/binding.h>

   void sec_rgy_site_open_update(
           unsigned_char_t *site_name,
           sec_rgy_handle_t *context,
           error_status_t *status);

 PARAMETERS

   Input

   site_name
          A character string (type unsigned_char_t) containing the name
          of an update registry site to bind to.  Supply this name in
          any of the following forms:

            + To choose the update site to bind to in the named cell,
              specify a cell name (for example, /.../r_d.com or /.:
              for the local cell)

            + To start the search for the update site at a specific
              replica in the replica's cell, specify either the site's
              global name (for example,
              /.../r_d.com/subsys/dce/sec/rs_server_250_2) or the site's
              network address (for example, ncadg_ip_udp:15.22.144.248)

   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_site_open_update() routine binds to a registry update site.
   A registry update site is a master server that may control several
   satellite (query) servers. To change the registry database, it is
   necessary to change a registry update site, which then automatically
   updates its associated query sites. No changes can be made directly to
   a registry query database.

   The site_name parameter identifies either the cell in which to find the
   update site or the replica at which to start the search for the update
   site. If site_name is NULL, or a zero-length string, an update site in
   the local cell is selected by the client agent.

   The handle for the associated registry server is returned in context.
   The handle is to an update site.  Use this registry context handle in
   subsequent calls that update or query the the registry database (for
   example, the sec_rgy_pgo_add() or sec_rgy_acct_lookup() call).  The
   caller must have established a valid network identity for this call to
   succeed.

 NOTES

   To bind to a registry update site, the use of the
   sec_rgy_site_bind_update() call is recommended in place of this call.

 FILES

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

 ERRORS

   sec_login_s_no_current_context
                The caller does not have a valid network login context.

   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_close
              sec_rgy_site_get
              sec_rgy_site_is_readonly
              sec_rgy_site_open
              sec_rgy_site_open_query