xdas_close_audit_stream(XDAS)

xdas_close_audit_stream -- close specified audit stream

Synopsis

cc [flag ...] file ... -Kthread -leels [library] ...

#include <sys/xdas.h>

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

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

xdas_close_audit_stream(XDAS) closes an audit stream, previously opened for reading, identified by the audit_stream_ref handle.

An audit stream is no longer valid for use in any XDAS function once it has been closed using any copy of the handle that refers to it.

NOTE: Any storage associated with an audit stream is reclaimed when it is closed.

The caller must possess the XDAS_AUDIT_READ authority.

On success, xdas_close_audit_stream(XDAS) returns XDAS_S_COMPLETE.

Arguments

minor_status: (Output) Provides further information when the function returns XDAS_S_FAILURE.
das_ref: (Input) A handle to the audit service obtained from a previous call to xdas_initialise_session(XDAS).
audit_stream_ref: (Input) A handle to the audit stream reference to be closed.

Return values

XDAS_S_AUTHORISATION_FAILURE: The caller does not possess the correct authority.
XDAS_S_COMPLETE: Successful completion.
XDAS_S_FAILURE: An implementation-specific error or failure has occurred, such as missing required parameters, or a malloc failure.
XDAS_S_INVALID_AUDIT_STREAM: The specified audit stream is invalid.
XDAS_S_INVALID_DAS_REF: The handle to the audit service is invalid.

References

xdas_initialise_session(XDAS), xdas_open_audit_stream(XDAS), xdas_rewind_audit_stream(XDAS)