<!--$Id: memp_set_pgcookie.so,v 10.17 2005/11/30 19:46:21 bostic Exp $--> <!--Copyright (c) 1997,2007 Oracle. All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB: DB_MPOOLFILE->set_pgcookie</title> <meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> <meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> </head> <body bgcolor=white> <table width="100%"><tr valign=top> <td> <h3>DB_MPOOLFILE->set_pgcookie</h3> </td> <td align=right> <a href="../../db46-devel-4.6.21/api_c/api_core.html"><img src="../../db46-devel-4.6.21/images/api.gif" alt="API"></a> <a href="../../db46-devel-4.6.21/ref/toc.html"><img src="../../db46-devel-4.6.21/images/ref.gif" alt="Ref"></a></td> </tr></table> <hr size=1 noshade> <tt> <h3><pre> #include <db.h> <p> int DB_MPOOLFILE->set_pgcookie(DB_MPOOLFILE *mpf, DBT *pgcookie); <p> int DB_MPOOLFILE->get_pgcookie(DB_MPOOLFILE *mpf, DBT *dbt); </pre></h3> <hr size=1 noshade> <h3>Description: DB_MPOOLFILE->set_pgcookie</h3> <p>The DB_MPOOLFILE->set_pgcookie method specifies a byte string that is provided to the functions registered to do input or output processing of the file's pages as they are read from or written to, the backing filesystem store. (See the <a href="../../db46-devel-4.6.21/api_c/memp_register.html">DB_ENV->memp_register</a> documentation for more information.)</p> <p>The DB_MPOOLFILE->set_pgcookie method configures a file in the memory pool, not only operations performed using the specified <a href="../../db46-devel-4.6.21/api_c/mempfile_class.html">DB_MPOOLFILE</a> handle.</p> <p>The DB_MPOOLFILE->set_pgcookie method may not be called after the <a href="../../db46-devel-4.6.21/api_c/memp_fopen.html">DB_MPOOLFILE->open</a> method is called. If the file is already open in the memory pool when <a href="../../db46-devel-4.6.21/api_c/memp_fopen.html">DB_MPOOLFILE->open</a> is called, the information specified to DB_MPOOLFILE->set_pgcookie will replace the existing information.</p> <p>The DB_MPOOLFILE->set_pgcookie method returns a non-zero error value on failure and 0 on success. </p> <h3>Parameters</h3> <dl compact> <dt><b>pgcookie</b><dd>The <b>pgcookie</b> parameter is a byte string provided to the functions registered to do input or output processing of the file's pages. </dl> <hr size=1 noshade> <h3>Description: DB_MPOOLFILE->get_pgcookie</h3> <p>The DB_MPOOLFILE->get_pgcookie method returns the byte string.</p> <p>The DB_MPOOLFILE->get_pgcookie method may be called at any time during the life of the application.</p> <p>The DB_MPOOLFILE->get_pgcookie method returns a non-zero error value on failure and 0 on success. </p> <h3>Parameters</h3> <dl compact> <dt><b>dbt</b><dd>The DB_MPOOLFILE->get_pgcookie method returns a reference to the byte string in <b>dbt</b>. </dl> <hr size=1 noshade> <h3>Class</h3> <a href="../../db46-devel-4.6.21/api_c/env_class.html">DB_ENV</a>, <a href="../../db46-devel-4.6.21/api_c/mempfile_class.html">DB_MPOOLFILE</a> <h3>See Also</h3> <a href="../../db46-devel-4.6.21/api_c/memp_list.html">Memory Pools and Related Methods</a> </tt> <table width="100%"><tr><td><br></td><td align=right> <a href="../../db46-devel-4.6.21/api_c/api_core.html"><img src="../../db46-devel-4.6.21/images/api.gif" alt="API"></a><a href="../../db46-devel-4.6.21/ref/toc.html"><img src="../../db46-devel-4.6.21/images/ref.gif" alt="Ref"></a> </td></tr></table> <p><font size=1>Copyright (c) 1996,2007 Oracle. All rights reserved.</font> </body> </html>