blob: 707973ec51e326e7d5768c48704043c98b162dd0 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
|
PR_LoadLibrary
==============
Loads a referenced library.
Syntax
------
.. code::
#include <prlink.h>
PRLibrary* PR_LoadLibrary(const char *name);
Parameters
~~~~~~~~~~
The function has this parameter:
``name``
A platform-dependent character array that names the library to be
loaded, as returned by :ref:`PR_GetLibraryName`.
Returns
~~~~~~~
If successful, returns a reference to an opaque :ref:`PRLibrary` object.
If the operation fails, returns ``NULL``. Use :ref:`PR_GetError` to find
the reason for the failure.
Description
-----------
This function loads and returns a reference to the specified library.
The returned reference becomes the library's identity. The function
suppresses duplicate loading if the library is already known by the
runtime.
Each call to :ref:`PR_LoadLibrary` must be paired with a corresponding call
to :ref:`PR_UnloadLibrary` in order to return the runtime to its original
state.
|
