sec_rgy_site_open-Binds to a registry site
#include <dce/binding.h>
void sec_rgy_site_open(
unsigned_char_t *site_name,
sec_rgy_handle_t *context,
error_status_t *status);
Input
- site_name
A pointer to 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)
Note that if you specify the name of a specific secd to bind to and the name is not valid, the call will bind to a random site in the cell if the specified cell name is valid.
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_open() routine binds to a registry site at the level of security specified in the rpc_binding_set_auth_info() call. 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. The caller must have established a valid network identity for this call to succeed.
To bind to a registry site, the use of the sec_rgy_site_bind() call is recommended in place of this call.Like sec_rgy_site_open_query() routine, 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_open_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
No currently established network identity for which context exists.
- sec_rgy_server_unavailable
Server unavailable.
Functions:sec_rgy_site_close() ,sec_rgy_site_is_readonly() ,sec_rgy_site_open_query() ,sec_rgy_site_open_update() .
Contents | Next section | Index |