NAME

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_info

A 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

h

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

status

A 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

13m

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