HELPLIB.HLB  —  DCE  DCE_INTRO, dce_attr_intro, dce_attr_sch_bind
 NAME
   dce_attr_sch_bind - Return 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_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

   SYS$COMMON:[DCE$LIBRARY]DCE_ATTR_BASE.IDL
                The idl file from which dce/dce_attr_base.h was derived.

 ERRORS

   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
              dce_attr_sch_bind_free
Close Help