PR_GetIdentitiesLayer

Finds the layer with the specified identity in the specified stack of layers.

Syntax

#include <prio.h>

PRFileDesc* PR_GetIdentitiesLayer(
  PRFileDesc* stack, 
  PRDescIdentity id);

Parameters

The function has the following parameters:

stack
A pointer to a 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.