38 lines
918 B
Markdown
38 lines
918 B
Markdown
# 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.
|