xdas_close_audit_stream(3xdas)


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(3xdas) function is a member of the Basic XDAS Conformance class.

xdas_close_audit_stream(3xdas) 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(3xdas) 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(3xdas).

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(3xdas), xdas_open_audit_stream(3xdas), xdas_rewind_audit_stream(3xdas)


© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004