NAME

sec_rgy_site_binding_get_info — Returns information from the registry binding handle

Synopsis

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

contextA 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_nameThe 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_infoA 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). 

statusA 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

/usr/include/dce/binding.idl
The idl file from which dce/binding.h was derived. 

Errors

The following describes a partial list of errors that might be returned.  Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages. 

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(3sec), sec_rgy_site_bind(3sec), sec_rgy_site_open(3sec).