NAME

sec_rgy_site_bind-Binds to a registry site

SYNOPSIS

#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);

PARAMETERS

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.

DESCRIPTION

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.

NOTES

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

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

The caller does not have a valid network login context.

sec_rgy_server_unavailable

The DCE Registry Server is unavailable.

SEE ALSO

Functions: sec_rgy_site_open(), sec_rgy_cell_bind().