Kernel32LoadLibraryEx Method

Loads the specified module into the address space of the calling process.

The specified module may cause other modules to be loaded.

Definition

Namespace: DevCase.Win32.NativeMethods
Assembly: DevCase.net48 (in DevCase.net48.dll) Version: 6.0.0.0 (6.0)
XMLNS for XAML: Not mapped to an xmlns.
[DllImportAttribute("Kernel32.dll", CharSet = CharSet.Auto, BestFitMapping = false, 
	ThrowOnUnmappableChar = true, SetLastError = true)]
public static SafeModuleHandle LoadLibraryEx(
	string fileName,
	[OptionalAttribute] IntPtr hFile,
	LoadLibraryFlags flags
)

Parameters

fileName  String
A string that specifies the file name of the module to load.

This name is not related to the name stored in a library module itself, as specified by the LIBRARY keyword in the module-definition (.def) file.

The module can be a library module (a .dll file) or an executable module (an .exe file). If the specified module is an executable module, static imports are not loaded; instead, the module is loaded as if DontResolveDllReferences was specified.

If the string specifies a module name without a path and the file name extension is omitted, the function appends the default library extension .dll to the module name. To prevent the function from appending .dll to the module name, include a trailing point character (.) in the module name string.

If the string specifies a fully qualified path, the function searches only that path for the module. When specifying a path, be sure to use backslashes (\), not forward slashes (/).

If the string specifies a module name without a path and more than one loaded module has the same base name and extension, the function returns a handle to the module that was loaded first.

If the string specifies a module name without a path and a module of the same name is not already loaded, or if the string specifies a module name with a relative path, the function searches for the specified module. The function also searches for modules if loading the specified module causes the system to load other associated modules (that is, if the module has dependencies). The directories that are searched and the order in which they are searched depend on the specified path and the flags parameter.

If the function cannot find the module or one of its dependencies, the function fails.

hFile  IntPtr  (Optional)
This parameter is reserved for future use. It must be NULL.
flags  LoadLibraryFlags
The action to be taken when loading the module.

If no flags are specified, the behavior of this function is identical to that of the LoadLibrary function.

Return Value

SafeModuleHandle
If the function succeeds, the return value is a handle to the loaded module.

If the function fails, the return value is Zero.

To get extended error information, call GetLastWin32Error.

Remarks

See Also