NAME

dce_aud_discard — Discards an audit record (releases the memory).  Used by client/server applications and trail analysis and examination tools. 

Synopsis

void dce_aud_discard(
dce_aud_rec_t ard,
unsigned32∗ status);

Parameters

Input

ardDesignates an audit record descriptor that was returned by a previously successful call to one of the dce_aud_start_∗() functions or the dce_aud_next() function. 

Output

statusThe status code returned by this routine.  This status code indicates whether the routine was completed successfully or not.  If the routine was not completed successfully, the reason for the failure is given. 

Description

The dce_aud_discard() function releases the memory used by the audit record descriptor and the associated audit record that is to be discarded. 

Return Values

No value is returned. 

Errors

The following describes a partial list of errors that might be returned.  Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages. 

aud_s_ok
The call was successful.

Status codes passed from dce_aud_free_header()

Related Information

Functions: dce_aud_open(3sec), dce_aud_start(3sec), dce_aud_start_with_name(3sec), dce_aud_start_with_pac(3sec), dce_aud_start_with_server_binding(3sec).