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.