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

 NAME
   sec_rgy_site_get - Returns the string representation for a bound
                      registry site

 SYNOPSIS

   #include <dce/binding.h>

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

 PARAMETERS

   Input

   context
          An opaque handle indicating (bound to'') a registry server.
          Use sec_rgy_site_open() to acquire a bound handle.  To obtain
          information on the default binding handle, initialize context
          to sec_rgy_default_handle.  A valid login context must be set
          for the process if context is set to sec_rgy_default_handle;
          otherwise the error sec_under_login_s_no_current_context is
          returned.

   Output

   site_name
          A pointer to a character string (type unsigned_char_t)
          containing the returned name of the registry site associated
          with context, the given registry server handle.
          The name is either a global name or a network address,
          depending on the form in which the name was input to the call
          that bound to the 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_get() routine returns the name of the registry site
   associated with the specified handle. If the handle is the default
   context, the routine returns the name of the default context's site.
   Memory is allocated for the string returned in the site_name
   parameter. The application calls the rpc_string_free() routine to
   deallocate that memory.

 NOTES

   To obtain binding information, the use of the
   sec_rgy_site_binding_get_info() 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_under_login_s_no_current_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_open