dce_attr_sch_bind(3dce)
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
/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)