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

 NAME
   sec_rgy_site_binding_get_info - Returns information from the registry
                                   binding handle

 SYNOPSIS

   #include <dce/binding.h>

   void sec_rgy_site_binding_get_info(
           sec_rgy_handle_t context,
           unsigned_char_t **cell_name,
           unsigned_char_t **server_name,
           unsigned_char_t **string_binding,
           sec_rgy_bind_auth_info_t *auth_info,
           error_status_t *status);

 PARAMETERS

   Input

   context
          A sec_rgy_handle_t variable that contains a registry server
          handle indicating ("bound to") the desired registry site.  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

   cell_name
          The name of the home cell for this registry.

   server_name
          The name of the node on which the server is resident. This 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.

   string_binding
          A string containing binding information from sec_rgy_handle_t.

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

   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_binding_get_info() routine returns the site name and
   authentication information associated with the context parameter.  If
   the context is the default context, the information for the default
   binding is returned. Passing in a NULL value for any of the output
   values (except for status) will prevent that value from being returned.
   Memory is allocated for the string returned in the cell_name,
   server_name, and string_binding parameters. The application calls the
   rpc_string_free() routine to deallocate that memory.

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