dce_aud_discard(3sec)
Discards an audit record (releases the memory).
Used by client/server applications and trail analysis and examination tools.
Synopsis
#include <dce/audit.h>
void dce_aud_discard(
dce_aud_rec_t ard,
unsigned32
*status);
Parameters
Input
ard
Designates 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
status
The 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_start_with_server_binding(3sec)