NAME

sec_rgy_attr_cursor_reset-Reinitializes a cursor that has been allocated with either sec_rgy_attr_cursor_init() or sec_rgy_attr_cursor_alloc()

SYNOPSIS

#include <dce/sec_rgy_attr.h>

void sec_attr_cursor_reset(
    sec_attr_cursor_t *cursor, 
    error_status_t *status);

PARAMETERS

Input/Output

cursor

A pointer to a sec_attr_cursor_t. As an input parameter, an initialized cursor. As an output parameter, cursor is reset to the first attribute in the schema.

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_cursor_reset() routine resets a dce_attr_cursor_t that has been allocated by either a sec_rgy_attr_cursor_init() or sec_rgy_attr_cursor_alloc() call. The reset cursor can then be used to process a new sec_rgy_attr_lookup_by_id() query by reusing the cursor instead of releasing and re-allocating it. This is a local operation and makes no remote calls.

Permissions Required

None.

FILES

/usr/include/dce/sec_rgy_attr.idl

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

ERRORS

error_status_ok

The call was successful.

SEE ALSO

Functions: sec_rgy_attr_cursor_init(), sec_rgy_attr_cursor_alloc(), sec_rgy_attr_lookup_by_id().