NAME

xdas_discard_record - discard a previously created audit record

SYNOPSIS

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

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.

Note:

An implementation may reclaim any storage associated with an audit record descriptor when that audit record descriptor is discarded.

RETURN VALUE

The following XDAS status codes shall be returned:

[XDAS_S_AUTHORIZATION_FAILURE]

The caller does not possess the required authority.

[XDAS_S_COMPLETE]

Successful completion.

[XDAS_S_FAILURE]

An implementation specific error or failure has occurred.

[XDAS_S_INVALID_DAS_REF]

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

[XDAS_S_INVALID_RECORD_DESCRIPTOR]

The specified audit record descriptor is not valid.

[XDAS_S_NOT_SUPPORTED]

The called function is not supported by this implementation.

ERRORS

No other errors are defined.

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