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

 NAME
   sec_rgy_site_bind_query - Binds to a registry query site

 SYNOPSIS

   #include <dce/binding.h>

   void sec_rgy_site_bind_query(
           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_query() routine binds to a registry query site
   at an arbitrary level of security. A registry query site is a satellite
   server that operates on a periodically updated copy of the main
   registry database.  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 the query site to use.  If site_name
   is NULL, or a zero-length string, a query site in the local cell is
   selected by the client agent.

   The handle for the associated registry server is returned in context.

 NOTES

   Like sec_rgy_bind_open() 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_site_bind