sec_rgy_site_bind-Binds to a registry site
#include <dce/binding.h>
void sec_rgy_site_bind(
unsigned_char_t *site_name,
sec_rgy_bind_auth_info_t *auth_info,
sec_rgy_handle_t *context,
error_status_t *status);
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.
The sec_rgy_site_bind() call binds to a registry site at the security level specified by the auth_info parameter. The site_name parameter identifies the registry to use. If site_name is NULL, or a zero-length string, a registry site in the local cell is selected by the client agent.
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().
- /usr/include/dce/binding.idl
The idl file from which dce/binding.h was derived.
- error_status_ok
The call was successful.
- 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.
Functions:sec_rgy_site_open() ,sec_rgy_cell_bind() .
Contents | Next section | Index |