PreviousNext

sec_rgy_attr_cursor_reset(3sec)

Reinitializes a cursor

Synopsis

#include <dce/sec_attr_base.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( ). 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

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.

error_status_ok

Related Information
Functions:

sec_intro(3sec)

sec_rgy_attr_cursor_init(3sec)

sec_rgy_attr_cursor_alloc(3sec)

sec_rgy_attr_lookup_by_id(3sec)