NAME

xdas_rewind_audit_stream - rewind the audit stream

SYNOPSIS

OM_uint32 xdas_rewind_audit_stream ( 
    OM_uint32				*minor_status, 
    const xdas_audit_ref_t		*das_ref,
    xdas_audit_stream_t		*audit_stream_ref
);

DESCRIPTION

xdas_rewind_audit_stream() is a member of the Basic XDAS Conformance class.

The xdas_rewind_audit_stream() function rewinds the audit stream referred to by xdas_stream_ref so that the cursor associated with the xdas_stream_ref points to the first record in the audit stream. The caller must possess the XDAS_AUDIT_READ authority.

If successful, the function returns [XDAS_S_COMPLETE].

The arguments for xdas_rewind_audit_stream() are:

minor_status (out)

An implementation specific return status that provides additional information when [XDAS_S_FAILURE] is returned by the function.

das_ref (in)

The handle to the XDAS server, obtained from a previous call to xdas_initialize_session().

audit_stream_ref (in,out)

Handle to the audit stream which is to be rewound.

RETURN VALUE

The following XDAS status codes shall be returned:

[XDAS_S_AUTHORIZATION_FAILURE]

The caller does not possess the required authority.

[XDAS_S_COMPLETE]

Successful completion.

[XDAS_S_FAILURE]

An implementation specific error or failure has occurred.

[XDAS_S_INVALID_AUDIT_STREAM]

The specified audit stream is not valid.

[XDAS_S_INVALID_DAS_REF]

The audit service handle supplied does not point to the audit service.

ERRORS

No other errors are defined.

[??] Some characters or strings that appear in the printed document are not easily representable using HTML.