Restriction: This topic applies only when the Enterprise Server feature is enabled.
Syntax:
typedef int (*PFI_AUD_EMITTER_INIT)(cobuns32_t flags,
const cobuns8_t *emitter_name,
AUDIT_EMITTER_EVENT *audit_event,
void **emitter_data);
On Entry:
- flags
- Reserved for future use (must be 0)
- emitter_name
- Name of emitter being initialised
- audit_event
- Details of the first audit event to be output. (N.B. the event is not expected to be emitted during initialisation, but the information provided may be useful for file header creation (e.g. date/time))
On Exit:
- emitter_data
- Emitter-specific data
Return Codes:
| EMITTER_INIT_SUCCESS |
0 |
| EMITTER_INIT_FAIL |
-1 |
Comments:
This function is invoked by the audit facility to perform the emitter's initialisation. Initialisation would typically involve the interrogation of the audit facility for the emitter's configuration properties via calls to the CBL_AUDIT_EMITTER_PROPERTY_GET() API (see CBL_AUDIT_EMITTER_PROPERTY_GET() - Get an Audit Emitter Property Value).
Emitter initialisation is deferred by the audit facility until just prior to the first audit event needing to be output.