PR_CExitMonitor
===============

Decrement the entry count associated with a cached monitor.


Syntax
------

.. code::

   #include <prcmon.h>

   PRStatus PR_CExitMonitor(void *address);


Parameters
~~~~~~~~~~

The function has the following parameters:

``address``
   The address of the protected object--the same address previously
   passed to :ref:`PR_CEnterMonitor`.


Returns
~~~~~~~

The function returns one of the following values:

-  If successful, ``PR_SUCCESS``.
-  If unsuccessful, ``PR_FAILURE``. This may indicate that the address
   parameter is invalid or that the calling thread is not in the
   monitor.


Description
-----------

Using the value specified in the address parameter to find a monitor in
the monitor cache, :ref:`PR_CExitMonitor` decrements the entry count
associated with the monitor. If the decremented entry count is zero, the
monitor is exited.