xdas_commit_record - write a completed audit record to the audit stream
OM_uint32 xdas_commit_record ( OM_uint32 *minor_status, const xdas_audit_ref_t *das_ref, const xdas_audit_rec_desc_t *audit_record_descriptor );
xdas_commit_record()is a member of the Basic XDAS Conformance class.
xdas_commit_record()function writes the audit record identified by audit_record_descriptor to the current audit stream controlled by the audit service and accessed by das_ref. The XDAS implementation adds the time information to the audit record unless a previous call to xdas_timestamp_record()has been made using audit_record_descriptor. The caller must have the XDAS_AUDIT_SUBMIT authority.
If successful, the function returns [XDAS_S_COMPLETE].
If any of the event_number, outcome, initiator_information, target_information and event_info parameters to
xdas_start_record()and xdas_put_event_info()have not been completed in at least one such call, even when component fields are empty, then this call shall return [XDAS_S_INCOMPLETE_RECORD].
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 audit service obtained from a previous call to
- audit_record_descriptor (in)
A descriptor referring to a completed audit record to be written to the audit stream. On successful completion 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 closed.
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 record has not been fully populated by the caller.
The handle to the audit service is not valid.
The specified audit record descriptor is not valid.
The called function is not supported by this implementation.
There has been an audit service failure.
The audit record cannot be written to stable storage.
No other errors are defined.
[??] Some characters or strings that appear in the printed document are not easily representable using HTML.