NAME

xdas_open_audit_stream - open the audit_stream

SYNOPSIS

OM_uint32 xdas_open_audit_stream ( 
    OM_uint32				*minor_status,
    const xdas_audit_ref_t		*das_ref,
    xdas_audit_stream_t		**audit_stream_ref
);

DESCRIPTION

xdas_open_audit_stream() is a member of the Basic XDAS Conformance class.

The xdas_open_audit_stream() function opens the audit stream for reading and returns a handle to the audit stream in audit_stream_ref handle. A caller may obtain more than one handle to the audit stream, each of which is independent of any other handles. The caller must possess the XDAS_AUDIT_READ authority.

If successful, the function returns [XDAS_S_COMPLETE].

The arguments for xdas_open_audit_stream() 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 audit service obtained from a previous call to xdas_initialize_session.

audit_stream_ref (out)

Handle to the audit stream returned by the function.

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 handle to the audit service is not valid.

ERROR

No other errors are defined.

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