NAME

xdas_import_event_records - imports records from an external audit service into XDAS in XDAS common format

SYNOPSIS

OM_uint32 xdas_import_event_records (
	OM_uint32				*minor_status,
    	const xdas_audit_ref_t		*das_ref,
	const xdas_buffer_t			*audit_record_buffer,
	OM_uint32				*position_in_buffer
);

DESCRIPTION

xdas_import_event_records() is a member of the XDAS Import API Option Conformance class.

The xdas_import_event_records() function allows a caller to import audit event records in the XDAS format directly to the XDAS service. The caller places one or more complete audit event records into the buffer referred to by audit-record_buffer from which they are copied and integrated into the XDAS audit stream. The function reads audit records until the start of a next record is not found. The implementation may select the records that are actually imported based upon some selection criteria. The caller is not advised of the disposition of the audit records it submits.

The caller must possess the XDAS_AUDIT_IMPORT authority.

If successful, the function returns [XDAS_S_COMPLETE].

The arguments for xdas_import_event_records() are:

minor_status (out)

An implementation specific return status that provides additional information when [XDAS_S_FAILURE] is returned by the function.

das_ref (in)

Handle to the XDAS service obtained by a previous call to xdas_initialize_session().

audit_record_buffer (in)

Buffer into which the caller places the audit records to be imported into the XDAS audit stream.

position_in_buffer (out)

If a record syntax error is detected this parameter contains the position in the buffer at which the syntax error was detected.

RETURN VALUE

The following XDAS status codes shall be returned:

[XDAS_S_AUTHORIZATION_FAILURE]

The caller does not possess the required authority.

[XDAS_S_COMPLETE]

Successful completion.

[XDAS_S_FAILURE]

An implementation specific error or failure has occurred.

[XDAS_S_INVALID_DAS_REF]

The audit service handle supplied does not point to the audit service.

[XDAS_S_NOT_SUPPORTED]

The called function is not supported by this implementation.

[XDAS_S_RECORD_SYNTAX_ERROR]

A syntax error has been detected in an input record.

ERRORS

No other errors are defined.

[??] Some characters or strings that appear in the printed document are not easily representable using HTML.