sec_rgy_site_binding_get_info(3sec)
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
/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: