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