Registers a default library pathname with a runtime.


#include <prlink.h>

PRStatus PR_SetLibraryPath(const char *path);


The function has this parameter:


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.


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


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.