| ## dce_aud_put_ev_info(3sec) Adds event-specific information to a specified audit record buffer. Used by client/server applications. Synopsis #include <dce/audit.h> void dce_aud_put_ev_info( dce_aud_rec_t ard, dce_aud_ev_info_t info, unsigned32 *status); Parameters Input ard A pointer to an audit record descriptor initialized by one of the dce_aud_start_*( ) functions. info A data structure containing an event-specific information item that is to be appended to the tail of the audit record identified by ard. The possible formats of the event-specific information are listed in the sec_intro(3sec) topic. 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_put_ev_info( ) function adds event-specific information to an audit record. The event-specific information is included in an audit record by calling dce_aud_put_ev_info( ) one or more times. The order of the information items included by multiple calls is preserved in the audit record, so that they may be read in the same order by the dce_aud_get_ev_info( ) function. This order is also observed by the dce_aud_print( ) function. The info parameter is a pointer to an instance of the self-descriptive dce_aud_ev_info_t structure. 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 input audit record descriptor is invalid. aud_s_evt_tail_info_exceeds_limit The tail portion of the audit trail record has exceeded its limit of 4K. aud_s_ok The call was successful. Related Information Functions: dce_aud_start(3sec) dce_aud_start_with_pac(3sec) dce_aud_start_with_name(3sec) dce_aud_start_with_server_binding(3sec) dce_aud_commit(3sec) dce_aud_open(3sec) ##