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

 NAME
   sec_rgy_site_open - Binds to a registry site

 SYNOPSIS

   #include <dce/binding.h>

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

 PARAMETERS

   Input

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

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

            + To bind to a specific site in a specific 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)

   Note that if you specify the name of a specific secd to bind to and
   the name is not valid, the call will bind to a random site in the cell
   if the specified cell name is valid.

   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() routine binds to a registry site at the level
   of security specified in the rpc_binding_set_auth_info() call.  The
   site_name parameter identifies the registry to use.  If site_name is
   NULL, or a zero-length string, a registry site in the local cell is
   selected by the client agent.  The caller must have established a
   valid network identity for this call to succeed.

 NOTES

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

   Like sec_rgy_site_open_query() routine, this routine binds arbitrarily
   to either an update or query site.  Although update sites can accept
   queries, query sites cannot accept updates.  To specifically select
   an update site, use sec_rgy_site_open_update().

 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 requested registry server is not available.

   error_status_ok
                The call was successful.

 RELATED INFORMATION

   Functions: sec_intro
              sec_rgy_site_close
              sec_rgy_site_is_readonly
              sec_rgy_site_open_query
              sec_rgy_site_open_update