NAME

sec_rgy_site_open_query-Binds to a registry query site

SYNOPSIS

#include <dce/binding.h>

void sec_rgy_site_open_query(
    unsigned_char_t *site_name,
    sec_rgy_handle_t *context,
    error_status_t *status);

PARAMETERS

Input

site_name

A character string (type unsigned_char_t) containing the name of the registry query 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)

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.

DESCRIPTION

The sec_rgy_site_open_query() routine binds to a registry query site. A registry query site is a satellite server that operates on a periodically updated copy of the main registry database. To change the registry database, it is necessary to change a registry update site, which then automatically updates its associated query sites. No changes can be made directly to a registry query database.

The site_name parameter identifies the query site to use. If site_name is NULL, or a zero-length string, a query site in the local cell is selected by the client agent.

The handle for the associated registry server is returned in context.

The caller must have established a valid network identity for this call to succeed.

NOTES

To bind to a registry query site, the use of the sec_rgy_site_bind_query() call is recommended in place of this call.

Like sec_rgy_site_open() 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().

FILES

/usr/include/dce/binding.idl

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

ERRORS

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.

SEE ALSO

Functions: sec_rgy_site_close(), sec_rgy_site_get(), sec_rgy_site_is_readonly(), sec_rgy_site_open(), sec_rgy_site_open_update().