Loads a referenced library.
Syntax
#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
PR_GetLibraryName.
Returns
If successful, returns a reference to an opaque PRLibrary object.
If the operation fails, returns NULL. Use 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 PR_LoadLibrary must be paired with a corresponding call to PR_UnloadLibrary in order to return the runtime to its original state.