NAME

sec_rgy_attr_cursor_reset — Reinitializes a cursor

Synopsis

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

Parameters

Input/Output

cursorA 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. 

statusA 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 reallocating 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_alloc(3sec), sec_rgy_attr_cursor_init(3sec), sec_rgy_attr_lookup_by_id(3sec).