#include <db.h>

int
DB_MPOOLFILE->get_priority(DB_MPOOLFILE *mpf, 
                           DB_CACHE_PRIORITY *priorityp); 

The DB_MPOOLFILE->get_priority() method returns the cache priority for the file referenced by the DB_MPOOLFILE handle. The priority of a page biases the replacement algorithm to be more or less likely to discard a page when space is needed in the cache. This value is set using the DB_MPOOLFILE->set_priority() method.

The DB_MPOOLFILE->get_priority() method may be called at any time during the life of the application.

The DB_MPOOLFILE->get_priority() method returns a non-zero error value on failure and 0 on success.