sec_rgy_site_bind(3sec)
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) specifying the security server to bind to in one of the following forms:
· To bind to an arbitrary security server site in a named cell, specify a cell name (for example, /../r_d.com) or /.: for the local cell.
· To bind to a specific security server site in a specific cell, specify either the cell name and the server name (for example, /.../r_d.com/subsys/dce/sec/rs_server_250_2) or the server's network address (for example, ncadg_ip_udp:15.22.144.248). If the server name is not valid, the routine binds to an arbitrary security site in the named cell.
Note that the routine ignores anything after the cell name that does not refer to an item in the Cell Directory Service (CDS) namespace. If the specified CDS namespace item does not resolve to a security server, the call fails.
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
Like the sec_rgy_site_bind_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_bind_update( ).
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_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.
error_status_ok
The call was successful.
Related Information
Functions: