LoadLibrary

Syntax

HANDLE LoadLibrary(lpLibFileName)

This function loads the library module contained in the specified file and retrieves a handle to the loaded module instance.

Parameter Type/Description  

lpLibFileName LPSTR Points to a string that names the library file. The string must be a null-terminated character string.  

Return Value

The return value identifies the instance of the loaded library module. Otherwise, it is a value less than 32 that specifies the error. The following list describes the error values returned by this function:

Value Meaning

0 Out of memory.
2 File not found.
3 Path not found.
5 Attempt to dynamically link to a task.
6 Library requires separate data segments for each task.
10 Incorrect Windows version.
11 Invalid .EXE file (non-Windows .EXE or error in .EXE image).
12 OS/2 application.
13 DOS 4.0 application.
14 Unknown .EXE type.
15 Attempt in protected (standard or 386 enhanced) mode to load an .EXE created for an earlier version of Windows.
16 Attempt to load a second instance of an .EXE containing multiple, writeable data segments.
17 Attempt in large-frame EMS mode to load a second instance of an application that links to certain nonshareable DLLs already in use.
18 Attempt in real mode to load an application marked for protected mode only.