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.
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
- 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.
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.