Previous section.

Distributed Audit Service (XDAS)
Copyright © 1998 The Open Group


xdas_discard_record - discard a previously created audit record


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


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

The xdas_discard_record() function clears the buffer specified by audit_record_descriptor and releases the memory used by it. The caller must have the XDAS_AUDIT_SUBMIT authority.

If successful, the function returns [XDAS_S_COMPLETE].

The arguments for xdas_discard_record() 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 XDAS service, obtained from a previous call to xdas_initialize_session.

audit_record_descriptor (in)

The audit record descriptor returned from a previous call to xdas_start_record. On successful completion the audit_record_descriptor is no longer a valid reference to an audit record.
An implementation may reclaim any storage associated with an audit record descriptor when that audit record descriptor is discarded.


The following XDAS status codes shall be returned:


The caller does not possess the required authority.


Successful completion.


An implementation specific error or failure has occurred.


The audit service handle supplied does not point to the audit service.


The specified audit record descriptor is not valid.


The called function is not supported by this implementation.


No other errors are defined.

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

Why not acquire a nicely bound hard copy?
Click here to return to the publication details or order a copy of this publication.

Contents Next section Index