NAME

sec_rgy_cell_bind — Binds to a registry in a cell

Synopsis

void sec_rgy_cell_bind(
unsigned_char_t ∗cell_name,
sec_rgy_bind_auth_info_t ∗auth_info,
sec_rgy_handle_t ∗context,
error_status_t ∗status);

Parameters

Input

cell_nameA character string (type unsigned_char_t) containing the name of the cell in question.  Upon return, a security server for that cell is associated with context, the registry server handle.  The cell must be specified completely and precisely.  This routine offers none of the pathname resolving services of sec_rgy_site_bind(). 

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

Output

contextA pointer to a sec_rgy_handle_t variable.  Upon return, this contains a registry server handle indicating (bound to) the desired registry site. 

statusA pointer to the completion status.  On successful completion, the routine returns error_status_ok.  Otherwise, it returns an error. 

Description

The sec_rgy_cell_bind() routine establishes a relationship with a registry site at an arbitrary level of security.  The cell_name parameter identifies the target cell. 

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_rgy_server_unavailable
The DCE registry server is unavailable.

error_status_ok
The call was successful.

Related Information

Functions: sec_intro(3sec), sec_rgy_site_bind(3sec).