NAME

xdas_create_filter - create the specified audit filter

SYNOPSIS

OM_uint32 xdas_create_filter ( 
    OM_uint32				*minor_status, 
    const xdas_audit_ref_t		*das_ref,
    const xdas_buffer_t		*name,
    const OM_uint32			 filter_type,
    const xdas_buffer_t		*filter_exp,
    const xdas_buffer_t		*filter_act
);

DESCRIPTION

xdas_create_filter() is a member of the XDAS Filter Management API Option Conformance class.

The xdas_create_filter() function creates a filter for the name specified. If a filter with the specified name already exists the call fails. On creation the filter is in a disabled state.

The caller must possess the XDAS_AUDIT_CONTROL authority.

If successful, the function returns [XDAS_S_COMPLETE].

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

name (in)

The name of the filter.

filter_type (in)

The type of filter. This may be either XDAS_C_SUBMIT or XDAS_C_IMPORT.

filter_exp (in)

The expression list which defines the criteria for detection of the event.

filter_act (in)

The list of actions to be taken when the event is submitted or imported.

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

The filter type supplied is not recognized.

[XDAS_S_INVALID_DAS_REF]

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

[XDAS_S_INVALID_FILTER]

The filter name supplied already exists.

[XDAS_S_INVALID_FILTER_EXP]

The filter expression supplied is not valid.

[XDAS_S_INVALID_FILTER_TYPE]

The filter type supplied is not recognized.

[XDAS_S_NOT_SUPPORTED]

The called function is not supported by this implementation.

ERRORS

No other errors are defined.

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