NAME

sec_rgy_attr_sch_lookup_by_id-Read a schema entry identified by UUID

SYNOPSIS

#include <dce/sec_rgy_attr_sch.h>

void sec_rgy_attr_sch_lookup_by_id(
    sec_rgy_handle_t context,
    sec_attr_component_name_t schema_name, 
    uuid_t *attr_id,
    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_id

A pointer to a uuid_t that identifies a schema entry.

Output

schema_entry

A sec_attr_schema_entry_t that contains an entry identified by attr_id.

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_id() routine reads a schema entry identified by attr_id. This routine is useful for programmatic access.

Permissions Required

The sec_rgy_attr_sch_lookup_by_id() 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_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_name(), sec_rgy_attr_sch_scan().