NAME

sec_rgy_attr_sch_cursor_alloc-Allocates resources to a cursor used with the sec_rgy_attr_sch_scan() call

SYNOPSIS

#include <dce/sec_rgy_attr_sch.h>

void sec_rgy_attr_sch_cursor_alloc(
    dce_attr_cursor_t *cursor,
    error_status_t *status);

PARAMETERS

Output

cursor

A pointer to a sec_attr_cursor_t.

status

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

DESCRIPTION

The sec_rgy_attr_sch_cursor_alloc() call allocates resources to a cursor used with the sec_rgy_attr_sch_scan() call. This routine, which is a local operation, does not initialize cursor.

The sec_rgy_attr_sch_cursor_init() routine, which makes a remote call, allocates and initializes the cursor. In addition, sec_rgy_attr_sch_cursor_init() returns the total number of entries found in the schema as an output parameter; sec_rgy_attr_sch_cursor_alloc() does not.

Permissions Required

None.

FILES

/usr/include/dce/sec_rgy_attr_sch.idl

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

ERRORS

error_status_ok

The call was successful.

sec_attr_no_memory

Unable to allocate memory.

SEE ALSO

Functions: sec_rgy_attr_sch_cursor_init(), sec_rgy_attr_sch_cursor_release(), sec_rgy_attr_sch_scan().