45 lines
977 B
ReStructuredText
45 lines
977 B
ReStructuredText
PR_SetLibraryPath
|
|
=================
|
|
|
|
Registers a default library pathname with a runtime.
|
|
|
|
|
|
Syntax
|
|
------
|
|
|
|
.. code::
|
|
|
|
#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.
|