NAME

dce_aud_length — Gets the length of a specified audit record.  Used by client/server applications and trail analysis and examination tools

Synopsis

unsigned32 dce_aud_length(
dce_aud_rec_t ard,
unsigned32 ∗status);

Parameters

Input

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

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_length() function gets the length of a designated audit record.  The designated record (in binary format) may be obtained from an audit trail by calling the dce_aud_open() and dce_aud_next() functions. 

Applications can use this function to know how much space an audit record will use before it is committed.  This function can also be used by audit trail analysis and examination tools to determine the space that a previously committed audit record uses before it is read. 

Return Values

The size of the specified audit record in number of bytes. 

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.

Status codes passed from idl_es_encode_dyn_buffer()

Status codes passed from audit_pickle_dencode_ev_info()
(RPC IDL compiler)

Status codes passed from idl_es_handle_free()

Status codes passed from rpc_sm_client_free()

Related Information

Functions: dce_aud_next(3aud), dce_aud_open(3aud), dce_aud_put_ev_info(3aud), dce_aud_start(3aud), dce_aud_start_with_name(3aud), dce_aud_start_with_pac(3aud), dce_aud_start_with_server_binding(3aud).