NAME

xdas_list_filters - list the audit filters that have been defined

SYNOPSIS

OM_uint32 xdas_list_filters ( 
    OM_uint32					*minor_status,  
    const xdas_audit_ref_t			*das_ref,
    xdas_buffer_t				**filter_name_list
);

DESCRIPTION

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

The xdas_list_filters() function yields a pointer to an array of pointers to buffers holding the names of the filters. The last pointer in the array is NULL. The caller must possess the XDAS_AUDIT_CONTROL authority.

The memory for holding the array of pointers and the name filter buffers is allocated by (). When the list of filter names is no longer required, the caller should call xdas_release_filter_list() to release the memory used to hold the list of filter names.

If successful, the function returns [XDAS_S_COMPLETE].

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

filter_name_list (out)

The list of the names of the filters that exist within the XDAS service.

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 XDAS server supplied does not point to the audit service.

[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.