48 lines
936 B
ReStructuredText
48 lines
936 B
ReStructuredText
PR_GetIdentitiesLayer
|
|
=====================
|
|
|
|
Finds the layer with the specified identity in the specified stack of
|
|
layers.
|
|
|
|
|
|
Syntax
|
|
------
|
|
|
|
.. code::
|
|
|
|
#include <prio.h>
|
|
|
|
PRFileDesc* PR_GetIdentitiesLayer(
|
|
PRFileDesc* stack,
|
|
PRDescIdentity id);
|
|
|
|
|
|
Parameters
|
|
~~~~~~~~~~
|
|
|
|
The function has the following parameters:
|
|
|
|
``stack``
|
|
A pointer to a :ref:`PRFileDesc` object that is a layer in a stack of
|
|
layers.
|
|
``id``
|
|
The identity of the specified layer.
|
|
|
|
|
|
Returns
|
|
~~~~~~~
|
|
|
|
The function returns one of the following values:
|
|
|
|
- If successful, a pointer to a file descriptor of the layer with the
|
|
specified identity in the given stack of layers.
|
|
- If not successful, ``NULL``.
|
|
|
|
|
|
Description
|
|
-----------
|
|
|
|
The stack of layers to be searched is specified by the fd parameter,
|
|
which is a layer in the stack. Both the layers underneath fd and the
|
|
layers above fd are searched to find the layer with the specified
|
|
identity.
|