NAME

xdas_close_audit_stream - close the specified audit_stream

SYNOPSIS

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

DESCRIPTION

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

The xdas_close_audit_stream() function closes the audit stream, previously opened for reading, specified by the audit_stream_ref handle.

Once an audit stream is closed, using any copy of the handle that refers to that audit stream, that audit stream is no longer valid for use in any XDAS function call.

Note:

An implementation may reclaim any storage associated with an audit stream when that audit stream is closed.

The caller must possess the XDAS_AUDIT_READ authority.

If successful, the function returns [XDAS_S_COMPLETE]

The arguments for xdas_close_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)

Handle to the audit service obtained from a previous call to xdas_initialize_session().

audit_stream_ref (in)

Handle to the audit stream reference which is to be closed.

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 handle to the audit service is not valid.

ERROR

No other errors are defined.

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