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_with_server_binding(3sec)