Previous section.

Distributed Audit Service (XDAS)
Copyright © 1998 The Open Group


xdas_list_filters - list the audit filters that have been defined


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


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.


The following XDAS status codes shall be returned:


The caller does not possess the required authority.


Successful completion.


An implementation specific error or failure has occurred.


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


The called function is not supported by this implementation.


No other errors are defined

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

Why not acquire a nicely bound hard copy?
Click here to return to the publication details or order a copy of this publication.

Contents Next section Index