pr_getlibrarypath.rst (703B)
1 PR_GetLibraryPath 2 ================= 3 4 Retrieves the current default library path. 5 6 7 Syntax 8 ------ 9 10 .. code:: 11 12 #include <prlink.h> 13 14 char* PR_GetLibraryPath(void); 15 16 17 Parameters 18 ~~~~~~~~~~ 19 20 The function has no parameters. 21 22 23 Returns 24 ~~~~~~~ 25 26 A copy of the default library pathname string. In case of error, returns 27 NULL. 28 29 30 Description 31 ----------- 32 33 This function retrieves the current default library pathname, copies it, 34 and returns the copy. If sufficient storage cannot be allocated to 35 contain the copy, the function returns ``NULL``. Storage for the result 36 is allocated by the runtime and becomes the responsibility of the 37 caller. When it is no longer used, free it using :ref:`PR_FreeLibraryName`.