DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

xdas_discard_record(D3xdas)


xdas_discard_record -- discard a previously created audit record

Synopsis

#include <sys/xdas.h>

OM_uint32 xdas_discard_record( OM_uint32 *minor_status, const xdas_audit_ref_t *das_ref, const xdas_audit_desc_t *audit_record_descriptor);

Description

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

xdas_discard_record(D3xdas) clears the buffer specified by audit_record_descriptor and releases the memory used by it.

The caller must possess the XDAS_AUDIT_SUBMIT authority.

On success, xdas_discard_record(D3xdas) returns XDAS_S_COMPLETE.

Arguments


minor_status
(Output) Provides additional information when the function returns XDAS_S_FAILURE.

das_ref
(Input) A handle to the XDAS server, obtained from a previous call to xdas_initialise_session(D3xdas).

audit_record_descriptor
(Input) The audit record descriptor returned from a previous call to xdas_start_record(D3xdas). On successful completion, the audit_record_descriptor is no longer a valid reference to an audit record.


NOTE: Any storage associated with an audit record descriptor is reclaimed when the audit record descriptor is discarded.

Return values


XDAS_S_COMPLETE
Successful completion.

XDAS_S_FAILURE
An implementation-specific error or failure has occurred, such as missing required parameters, or a kernel allocated memory failure.

XDAS_S_INVALID_DAS_REF
The handle to the audit service does not point to the audit daemon.

XDAS_S_INVALID_RECORD_DESCRIPTOR
The specified audit record descriptor is invalid.

References

xdas_discard_record, xdas_commit_record(D3xdas), xdas_initialise_session(D3xdas)


© 2005 The SCO Group, Inc. All rights reserved.
OpenServer 6 and UnixWare (SVR5) HDK - 19 June 2005