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

 NAME
   sec_rgy_site_bind - Binds to a registry site

 SYNOPSIS

   #include <dce/binding.h>

   void sec_rgy_site_bind(
           unsigned_char_t *site_name,
           sec_rgy_bind_auth_info_t *auth_info,
           sec_rgy_handle_t *context,
           error_status_t *status);

 PARAMETERS

   Input

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

   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). If the
          sec_rgy_bind_auth_info_t structure specifies authenticated rpc,
          the caller must have established a valid network identity for
          this call to succeed.

   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_bind() call binds to a registry site at the security
   level specified by the auth_info parameter. 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.

 NOTES

   Like the sec_rgy_site_bind_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_bind_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 DCE Registry Server is unavailable.

   error_status_ok
                The call was successful.

 RELATED INFORMATION

   Functions: sec_intro
              sec_rgy_site_open
              sec_rgy_cell_bind