NAME

dce_aud_get_header — Gets the header of a specified audit record.  Used by the audit trail analysis and examination tools. 

Synopsis

void dce_aud_get_header(
dce_aud_rec_t ard,
dce_aud_hdr_t ∗∗header,
unsigned32 ∗status);

Parameters

Input

ardDesignates an audit record descriptor that was returned by a previously successful call to the dce_aud_next() function. 

Output

headerReturns the header information of the designated audit record. 

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_get_header() function gets the header information of a designated audit record.  The designated record is usually obtained from an audit trail by calling dce_aud_open() and dce_aud_next(). 

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_invalid_record_descriptor
The audit record descriptor is invalid.

aud_s_ok
The call was successful.

Related Information

Functions: dce_aud_next(3sec), dce_aud_open(3sec).