Removes a layer from the stack.
The function has the following parameters:
- A pointer to a
PRFileDescobject representing the stack from which the specified layer is to be removed.
- Identity of the layer to be removed from the stack.
The function returns one of the following values:
- If the layer is successfully removed from the stack, a pointer to the removed layer.
- If the layer is not found in the stack or cannot be popped (for example, the bottommost layer), the function returns
NULLwith the error code
PR_PopIOLayer pops the specified layer from the stack. If the object to be removed is found,
PR_PopIOLayer returns a pointer to the removed object The object then becomes the responsibility of the caller.
Even if the identity indicates the top layer of the stack, the reference returned is not the file descriptor for the stack and that file descriptor remains valid. In other words,
stack continues to point to the top of the stack after the function returns.