NAME

sec_rgy_attr_sch_lookup_by_name-Read a schema entry identified by name

SYNOPSIS

#include <dce/sec_rgy_attr_sch.h>

void sec_rgy_attr_sch_lookup_by_name(
    sec_rgy_handle_t context,
    sec_attr_component_name_t schema_name, 
    char *attr_name,
    sec_attr_schema_entry_t *schema_entry,
    error_status_t *status);

PARAMETERS

Input

context

An opaque handle bound to a registry server. Use sec_rgy_site_open() to acquire a bound handle.

schema_name

Reserved for future use.

attr_name

A pointer to a character string that identifies the schema entry.

Output

schema_entry

A sec_attr_schema_entry_t that contains the schema entry identified by attr_name.

status

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

DESCRIPTION

The sec_rgy_attr_sch_lookup_by_name() routine reads a schema entry identified by name. This routine is useful for use with an interactive editor.

Permissions Required

The sec_rgy_attr_sch_lookup_by_name() routine requires the r permission on the schema object.

FILES

/usr/include/dce/sec_rgy_attr_sch.idl

The idl file from which dce/sec_rgy_attr_sch.h was derived.

ERRORS

error_status_ok

The call was successful.

sec_attr_bad_name

Invalid attribute name specified.

sec_attr_no_memory

Unable to allocate memory.

sec_attr_sch_entry_not_found

Schema entry not found.

sec_attr_svr_unavailable

Server is unavailable.

sec_attr_unauthorized

Unauthorized to perform this operation.

SEE ALSO

Functions: sec_rgy_attr_sch_lookup_by_id(), sec_rgy_attr_sch_scan().