NAME

xdas_parse_record - parse an audit event record in an audit record buffer

SYNOPSIS

OM_uint32 xdas_parse_record (
    OM_uint32				*minor_status, 
    const xdas_audit_ref_t		*das_ref,
    const xdas_audit_desc_t	*audit_record_buffer,
    const OM_uint32			 record_number,
    xdas_audit_record_t		*audit_record
);

DESCRIPTION

xdas_parse_record() is a member of the XDAS Conformance class.

The xdas_parse_record() function parses and decomposes record number record_number in audit_record_buffer filled with a number of records by a previous call to xdas_get_next(). Records are extracted from audit_record_buffer by starting with record number 0 and interating until one less than the number of records returned by xdas_get_next().

If successful, the function returns [XDAS_S_COMPLETE].

If record_number does not match a record within audit_record_buffer then [XDAS_S_INVALID_RECORD_NUMBER] is returned.

The arguments for xdas_parse_record() 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)

The handle to the XDAS server, obtained from a previous call to xdas_initialize_session().

audit_record_buffer (in)

The handle to the audit record buffer populated by a previous call to xdas_get_next().

record_number (in)

The number of the record to be retrieved from audit_record_buffer. The first record is referred to by a record_number of 0. audit_record (in,out)"
The structure containing the fields of the parsed audit record.

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_INVALID_EVENT_NO]

The specified event number is not valid.

[XDAS_S_INVALID_INITIATOR_INFO]

The initiator information supplied has a syntax error.

[XDAS_S_INVALID_OUTCOME]

The specified outcome is not valid.

[XDAS_S_INVALID_RECORD_NUMBER]

The specified audit record number is not valid.

[XDAS_S_INVALID_TARGET_INFO]

The specified target information has a syntax error.

[XDAS_S_NO_AUDIT]

The event specified does not need to be audited.

[XDAS_S_NO_DECISION_YET]

The audit service has insufficient information to decide if the event requires auditing.

[XDAS_S_INVALID_EVENT_INFO]

The specified audit event information is not valid.

ERRORS

No other errors are defined.

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