Name

dce_attr_sch_bind - Returns an opaque handle to a schema object

Synopsis

#include <dce/dce_attr_base.h> void dce_attr_sch_bind(
dce_attr_component_name_t schema_name,
dce_bind_auth_info_t ∗auth_info,
dce_attr_sch_handle_t ∗h,
error_status_t ∗status);

Parameters

Input

schema_name
A pointer to a value of type dce_attr_component_name_t that specifies the name of the schema object to bind to. 

auth_infoA value of type dce_bind_auth_info_t that defines the authentication and authorization parameters to use with the binding handle.  If set to NULL, the default authentication and authorization parameters are used. 

Output

hAn opaque handle of type dce_attr_sch_handle_t to the named schema object for use with dce_attr_sch operations. 

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

Description

The dce_attr_sch_bind() routine returns an opaque handle of type dce_attr_sch_handle_t to a named schema object.  The returned handle can then be used for subsequent dce_attr_sch operations performed on the object. 

Permissions Required

The dce_attr_sch_update_entry() routine requires appropriate permissions on the schema object.  These permissions are managed by the target server. 

Files

/usr/include/dce/dce_attr_base.idl
The idl file from which dce/dce_attr_base.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. 

dce_attr_s_bad_name

sec_login_s_no_current_context

rpc_s_entry_not_found

rpc_s_no_more_bindings

dce_attr_s_unknown_auth_info_type

dce_attr_s_no_memory

error_status_ok

Related Information

Functions: dce_attr_intro(3dce), dce_attr_sch_bind_free(3dce).