Registers a default library pathname with a runtime.

Syntax

#include <prlink.h>

PRStatus PR_SetLibraryPath(const char *path);

Parameters

The function has this parameter:

path

A pointer to a character array that contains the directory path that the application should use as a default. The syntax of the pathname is not defined, nor whether that pathname should be absolute or relative.

Returns

The function returns one of the following values:

• If successful, PR_SUCCESS.
• If unsuccessful, PR_FAILURE. This may indicate that the function cannot allocate sufficient storage to make a copy of the path string

Description

This function registers a default library pathname with the runtime. This allows an environment to express policy decisions globally and lazily, rather than hardcoding and distributing the decisions throughout the code.