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.