pr_getidentitieslayer.md

Enable keyboard shortcuts

# 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.