winecfg: Update Portuguese translation.
[wine/testsucceed.git] / dlls / kernel32 / module.c
blob21db5cb55c1071697a648f71bdb39e6a8a6fed42
1 /*
2 * Modules
4 * Copyright 1995 Alexandre Julliard
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with this library; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
21 #include "config.h"
22 #include "wine/port.h"
24 #include <fcntl.h>
25 #include <stdarg.h>
26 #include <stdio.h>
27 #include <stdlib.h>
28 #include <string.h>
29 #include <sys/types.h>
30 #ifdef HAVE_UNISTD_H
31 # include <unistd.h>
32 #endif
33 #include "ntstatus.h"
34 #define WIN32_NO_STATUS
35 #include "winerror.h"
36 #include "windef.h"
37 #include "winbase.h"
38 #include "winternl.h"
39 #include "kernel_private.h"
41 #include "wine/exception.h"
42 #include "wine/debug.h"
43 #include "wine/unicode.h"
45 WINE_DEFAULT_DEBUG_CHANNEL(module);
47 #define NE_FFLAGS_LIBMODULE 0x8000
49 static WCHAR *dll_directory; /* extra path for SetDllDirectoryW */
51 static CRITICAL_SECTION dlldir_section;
52 static CRITICAL_SECTION_DEBUG critsect_debug =
54 0, 0, &dlldir_section,
55 { &critsect_debug.ProcessLocksList, &critsect_debug.ProcessLocksList },
56 0, 0, { (DWORD_PTR)(__FILE__ ": dlldir_section") }
58 static CRITICAL_SECTION dlldir_section = { &critsect_debug, -1, 0, 0, 0, 0 };
61 /****************************************************************************
62 * GetDllDirectoryA (KERNEL32.@)
64 DWORD WINAPI GetDllDirectoryA( DWORD buf_len, LPSTR buffer )
66 DWORD len;
68 RtlEnterCriticalSection( &dlldir_section );
69 len = dll_directory ? FILE_name_WtoA( dll_directory, strlenW(dll_directory), NULL, 0 ) : 0;
70 if (buffer && buf_len > len)
72 if (dll_directory) FILE_name_WtoA( dll_directory, -1, buffer, buf_len );
73 else *buffer = 0;
75 else
77 len++; /* for terminating null */
78 if (buffer) *buffer = 0;
80 RtlLeaveCriticalSection( &dlldir_section );
81 return len;
85 /****************************************************************************
86 * GetDllDirectoryW (KERNEL32.@)
88 DWORD WINAPI GetDllDirectoryW( DWORD buf_len, LPWSTR buffer )
90 DWORD len;
92 RtlEnterCriticalSection( &dlldir_section );
93 len = dll_directory ? strlenW( dll_directory ) : 0;
94 if (buffer && buf_len > len)
96 if (dll_directory) memcpy( buffer, dll_directory, (len + 1) * sizeof(WCHAR) );
97 else *buffer = 0;
99 else
101 len++; /* for terminating null */
102 if (buffer) *buffer = 0;
104 RtlLeaveCriticalSection( &dlldir_section );
105 return len;
109 /****************************************************************************
110 * SetDllDirectoryA (KERNEL32.@)
112 BOOL WINAPI SetDllDirectoryA( LPCSTR dir )
114 WCHAR *dirW;
115 BOOL ret;
117 if (!(dirW = FILE_name_AtoW( dir, TRUE ))) return FALSE;
118 ret = SetDllDirectoryW( dirW );
119 HeapFree( GetProcessHeap(), 0, dirW );
120 return ret;
124 /****************************************************************************
125 * SetDllDirectoryW (KERNEL32.@)
127 BOOL WINAPI SetDllDirectoryW( LPCWSTR dir )
129 WCHAR *newdir = NULL;
131 if (dir)
133 DWORD len = (strlenW(dir) + 1) * sizeof(WCHAR);
134 if (!(newdir = HeapAlloc( GetProcessHeap(), 0, len )))
136 SetLastError( ERROR_NOT_ENOUGH_MEMORY );
137 return FALSE;
139 memcpy( newdir, dir, len );
142 RtlEnterCriticalSection( &dlldir_section );
143 HeapFree( GetProcessHeap(), 0, dll_directory );
144 dll_directory = newdir;
145 RtlLeaveCriticalSection( &dlldir_section );
146 return TRUE;
150 /****************************************************************************
151 * DisableThreadLibraryCalls (KERNEL32.@)
153 * Inform the module loader that thread notifications are not required for a dll.
155 * PARAMS
156 * hModule [I] Module handle to skip calls for
158 * RETURNS
159 * Success: TRUE. Thread attach and detach notifications will not be sent
160 * to hModule.
161 * Failure: FALSE. Use GetLastError() to determine the cause.
163 * NOTES
164 * This is typically called from the dll entry point of a dll during process
165 * attachment, for dlls that do not need to process thread notifications.
167 BOOL WINAPI DisableThreadLibraryCalls( HMODULE hModule )
169 NTSTATUS nts = LdrDisableThreadCalloutsForDll( hModule );
170 if (nts == STATUS_SUCCESS) return TRUE;
172 SetLastError( RtlNtStatusToDosError( nts ) );
173 return FALSE;
177 /* Check whether a file is an OS/2 or a very old Windows executable
178 * by testing on import of KERNEL.
180 * FIXME: is reading the module imports the only way of discerning
181 * old Windows binaries from OS/2 ones ? At least it seems so...
183 static DWORD MODULE_Decide_OS2_OldWin(HANDLE hfile, const IMAGE_DOS_HEADER *mz, const IMAGE_OS2_HEADER *ne)
185 DWORD currpos = SetFilePointer( hfile, 0, NULL, SEEK_CUR);
186 DWORD ret = BINARY_OS216;
187 LPWORD modtab = NULL;
188 LPSTR nametab = NULL;
189 DWORD len;
190 int i;
192 /* read modref table */
193 if ( (SetFilePointer( hfile, mz->e_lfanew + ne->ne_modtab, NULL, SEEK_SET ) == -1)
194 || (!(modtab = HeapAlloc( GetProcessHeap(), 0, ne->ne_cmod*sizeof(WORD))))
195 || (!(ReadFile(hfile, modtab, ne->ne_cmod*sizeof(WORD), &len, NULL)))
196 || (len != ne->ne_cmod*sizeof(WORD)) )
197 goto broken;
199 /* read imported names table */
200 if ( (SetFilePointer( hfile, mz->e_lfanew + ne->ne_imptab, NULL, SEEK_SET ) == -1)
201 || (!(nametab = HeapAlloc( GetProcessHeap(), 0, ne->ne_enttab - ne->ne_imptab)))
202 || (!(ReadFile(hfile, nametab, ne->ne_enttab - ne->ne_imptab, &len, NULL)))
203 || (len != ne->ne_enttab - ne->ne_imptab) )
204 goto broken;
206 for (i=0; i < ne->ne_cmod; i++)
208 LPSTR module = &nametab[modtab[i]];
209 TRACE("modref: %.*s\n", module[0], &module[1]);
210 if (!(strncmp(&module[1], "KERNEL", module[0])))
211 { /* very old Windows file */
212 MESSAGE("This seems to be a very old (pre-3.0) Windows executable. Expect crashes, especially if this is a real-mode binary !\n");
213 ret = BINARY_WIN16;
214 goto good;
218 broken:
219 ERR("Hmm, an error occurred. Is this binary file broken?\n");
221 good:
222 HeapFree( GetProcessHeap(), 0, modtab);
223 HeapFree( GetProcessHeap(), 0, nametab);
224 SetFilePointer( hfile, currpos, NULL, SEEK_SET); /* restore filepos */
225 return ret;
228 /***********************************************************************
229 * MODULE_GetBinaryType
231 void MODULE_get_binary_info( HANDLE hfile, struct binary_info *info )
233 union
235 struct
237 unsigned char magic[4];
238 unsigned char class;
239 unsigned char data;
240 unsigned char version;
241 unsigned char ignored[9];
242 unsigned short type;
243 unsigned short machine;
244 } elf;
245 struct
247 unsigned int magic;
248 unsigned int cputype;
249 unsigned int cpusubtype;
250 unsigned int filetype;
251 } macho;
252 IMAGE_DOS_HEADER mz;
253 } header;
255 DWORD len;
257 memset( info, 0, sizeof(*info) );
259 /* Seek to the start of the file and read the header information. */
260 if (SetFilePointer( hfile, 0, NULL, SEEK_SET ) == -1) return;
261 if (!ReadFile( hfile, &header, sizeof(header), &len, NULL ) || len != sizeof(header)) return;
263 if (!memcmp( header.elf.magic, "\177ELF", 4 ))
265 if (header.elf.class == 2) info->flags |= BINARY_FLAG_64BIT;
266 /* FIXME: we don't bother to check byte order, architecture, etc. */
267 switch(header.elf.type)
269 case 2: info->type = BINARY_UNIX_EXE; break;
270 case 3: info->type = BINARY_UNIX_LIB; break;
273 /* Mach-o File with Endian set to Big Endian or Little Endian */
274 else if (header.macho.magic == 0xfeedface || header.macho.magic == 0xcefaedfe)
276 if ((header.macho.cputype >> 24) == 1) info->flags |= BINARY_FLAG_64BIT;
277 switch(header.macho.filetype)
279 case 2: info->type = BINARY_UNIX_EXE; break;
280 case 8: info->type = BINARY_UNIX_LIB; break;
283 /* Not ELF, try DOS */
284 else if (header.mz.e_magic == IMAGE_DOS_SIGNATURE)
286 union
288 IMAGE_OS2_HEADER os2;
289 IMAGE_NT_HEADERS32 nt;
290 } ext_header;
292 /* We do have a DOS image so we will now try to seek into
293 * the file by the amount indicated by the field
294 * "Offset to extended header" and read in the
295 * "magic" field information at that location.
296 * This will tell us if there is more header information
297 * to read or not.
299 info->type = BINARY_DOS;
300 if (SetFilePointer( hfile, header.mz.e_lfanew, NULL, SEEK_SET ) == -1) return;
301 if (!ReadFile( hfile, &ext_header, sizeof(ext_header), &len, NULL ) || len < 4) return;
303 /* Reading the magic field succeeded so
304 * we will try to determine what type it is.
306 if (!memcmp( &ext_header.nt.Signature, "PE\0\0", 4 ))
308 if (len >= sizeof(ext_header.nt.FileHeader))
310 info->type = BINARY_PE;
311 if (ext_header.nt.FileHeader.Characteristics & IMAGE_FILE_DLL)
312 info->flags |= BINARY_FLAG_DLL;
313 if (len < sizeof(ext_header.nt)) /* clear remaining part of header if missing */
314 memset( (char *)&ext_header.nt + len, 0, sizeof(ext_header.nt) - len );
315 switch (ext_header.nt.OptionalHeader.Magic)
317 case IMAGE_NT_OPTIONAL_HDR32_MAGIC:
318 info->res_start = (void *)(ULONG_PTR)ext_header.nt.OptionalHeader.ImageBase;
319 info->res_end = (void *)((ULONG_PTR)ext_header.nt.OptionalHeader.ImageBase +
320 ext_header.nt.OptionalHeader.SizeOfImage);
321 break;
322 case IMAGE_NT_OPTIONAL_HDR64_MAGIC:
323 info->flags |= BINARY_FLAG_64BIT;
324 break;
328 else if (!memcmp( &ext_header.os2.ne_magic, "NE", 2 ))
330 /* This is a Windows executable (NE) header. This can
331 * mean either a 16-bit OS/2 or a 16-bit Windows or even a
332 * DOS program (running under a DOS extender). To decide
333 * which, we'll have to read the NE header.
335 if (len >= sizeof(ext_header.os2))
337 if (ext_header.os2.ne_flags & NE_FFLAGS_LIBMODULE) info->flags |= BINARY_FLAG_DLL;
338 switch ( ext_header.os2.ne_exetyp )
340 case 1: info->type = BINARY_OS216; break; /* OS/2 */
341 case 2: info->type = BINARY_WIN16; break; /* Windows */
342 case 3: info->type = BINARY_DOS; break; /* European MS-DOS 4.x */
343 case 4: info->type = BINARY_WIN16; break; /* Windows 386; FIXME: is this 32bit??? */
344 case 5: info->type = BINARY_DOS; break; /* BOSS, Borland Operating System Services */
345 /* other types, e.g. 0 is: "unknown" */
346 default: info->type = MODULE_Decide_OS2_OldWin(hfile, &header.mz, &ext_header.os2); break;
353 /***********************************************************************
354 * GetBinaryTypeW [KERNEL32.@]
356 * Determine whether a file is executable, and if so, what kind.
358 * PARAMS
359 * lpApplicationName [I] Path of the file to check
360 * lpBinaryType [O] Destination for the binary type
362 * RETURNS
363 * TRUE, if the file is an executable, in which case lpBinaryType is set.
364 * FALSE, if the file is not an executable or if the function fails.
366 * NOTES
367 * The type of executable is a property that determines which subsystem an
368 * executable file runs under. lpBinaryType can be set to one of the following
369 * values:
370 * SCS_32BIT_BINARY: A Win32 based application
371 * SCS_DOS_BINARY: An MS-Dos based application
372 * SCS_WOW_BINARY: A Win16 based application
373 * SCS_PIF_BINARY: A PIF file that executes an MS-Dos based app
374 * SCS_POSIX_BINARY: A POSIX based application ( Not implemented )
375 * SCS_OS216_BINARY: A 16bit OS/2 based application
377 * To find the binary type, this function reads in the files header information.
378 * If extended header information is not present it will assume that the file
379 * is a DOS executable. If extended header information is present it will
380 * determine if the file is a 16 or 32 bit Windows executable by checking the
381 * flags in the header.
383 * ".com" and ".pif" files are only recognized by their file name extension,
384 * as per native Windows.
386 BOOL WINAPI GetBinaryTypeW( LPCWSTR lpApplicationName, LPDWORD lpBinaryType )
388 BOOL ret = FALSE;
389 HANDLE hfile;
390 struct binary_info binary_info;
392 TRACE("%s\n", debugstr_w(lpApplicationName) );
394 /* Sanity check.
396 if ( lpApplicationName == NULL || lpBinaryType == NULL )
397 return FALSE;
399 /* Open the file indicated by lpApplicationName for reading.
401 hfile = CreateFileW( lpApplicationName, GENERIC_READ, FILE_SHARE_READ,
402 NULL, OPEN_EXISTING, 0, 0 );
403 if ( hfile == INVALID_HANDLE_VALUE )
404 return FALSE;
406 /* Check binary type
408 MODULE_get_binary_info( hfile, &binary_info );
409 switch (binary_info.type)
411 case BINARY_UNKNOWN:
413 static const WCHAR comW[] = { '.','C','O','M',0 };
414 static const WCHAR pifW[] = { '.','P','I','F',0 };
415 const WCHAR *ptr;
417 /* try to determine from file name */
418 ptr = strrchrW( lpApplicationName, '.' );
419 if (!ptr) break;
420 if (!strcmpiW( ptr, comW ))
422 *lpBinaryType = SCS_DOS_BINARY;
423 ret = TRUE;
425 else if (!strcmpiW( ptr, pifW ))
427 *lpBinaryType = SCS_PIF_BINARY;
428 ret = TRUE;
430 break;
432 case BINARY_PE:
433 *lpBinaryType = (binary_info.flags & BINARY_FLAG_64BIT) ? SCS_64BIT_BINARY : SCS_32BIT_BINARY;
434 ret = TRUE;
435 break;
436 case BINARY_WIN16:
437 *lpBinaryType = SCS_WOW_BINARY;
438 ret = TRUE;
439 break;
440 case BINARY_OS216:
441 *lpBinaryType = SCS_OS216_BINARY;
442 ret = TRUE;
443 break;
444 case BINARY_DOS:
445 *lpBinaryType = SCS_DOS_BINARY;
446 ret = TRUE;
447 break;
448 case BINARY_UNIX_EXE:
449 case BINARY_UNIX_LIB:
450 ret = FALSE;
451 break;
454 CloseHandle( hfile );
455 return ret;
458 /***********************************************************************
459 * GetBinaryTypeA [KERNEL32.@]
460 * GetBinaryType [KERNEL32.@]
462 * See GetBinaryTypeW.
464 BOOL WINAPI GetBinaryTypeA( LPCSTR lpApplicationName, LPDWORD lpBinaryType )
466 ANSI_STRING app_nameA;
467 NTSTATUS status;
469 TRACE("%s\n", debugstr_a(lpApplicationName));
471 /* Sanity check.
473 if ( lpApplicationName == NULL || lpBinaryType == NULL )
474 return FALSE;
476 RtlInitAnsiString(&app_nameA, lpApplicationName);
477 status = RtlAnsiStringToUnicodeString(&NtCurrentTeb()->StaticUnicodeString,
478 &app_nameA, FALSE);
479 if (!status)
480 return GetBinaryTypeW(NtCurrentTeb()->StaticUnicodeString.Buffer, lpBinaryType);
482 SetLastError(RtlNtStatusToDosError(status));
483 return FALSE;
486 /***********************************************************************
487 * GetModuleHandleExA (KERNEL32.@)
489 BOOL WINAPI GetModuleHandleExA( DWORD flags, LPCSTR name, HMODULE *module )
491 WCHAR *nameW;
493 if (!name || (flags & GET_MODULE_HANDLE_EX_FLAG_FROM_ADDRESS))
494 return GetModuleHandleExW( flags, (LPCWSTR)name, module );
496 if (!(nameW = FILE_name_AtoW( name, FALSE ))) return FALSE;
497 return GetModuleHandleExW( flags, nameW, module );
500 /***********************************************************************
501 * GetModuleHandleExW (KERNEL32.@)
503 BOOL WINAPI GetModuleHandleExW( DWORD flags, LPCWSTR name, HMODULE *module )
505 NTSTATUS status = STATUS_SUCCESS;
506 HMODULE ret;
507 ULONG magic;
509 /* if we are messing with the refcount, grab the loader lock */
510 if ((flags & GET_MODULE_HANDLE_EX_FLAG_PIN) ||
511 !(flags & GET_MODULE_HANDLE_EX_FLAG_UNCHANGED_REFCOUNT))
512 LdrLockLoaderLock( 0, NULL, &magic );
514 if (!name)
516 ret = NtCurrentTeb()->Peb->ImageBaseAddress;
518 else if (flags & GET_MODULE_HANDLE_EX_FLAG_FROM_ADDRESS)
520 void *dummy;
521 if (!(ret = RtlPcToFileHeader( (void *)name, &dummy ))) status = STATUS_DLL_NOT_FOUND;
523 else
525 UNICODE_STRING wstr;
526 RtlInitUnicodeString( &wstr, name );
527 status = LdrGetDllHandle( NULL, 0, &wstr, &ret );
530 if (status == STATUS_SUCCESS)
532 if (flags & GET_MODULE_HANDLE_EX_FLAG_PIN)
533 FIXME( "should pin refcount for %p\n", ret );
534 else if (!(flags & GET_MODULE_HANDLE_EX_FLAG_UNCHANGED_REFCOUNT))
535 LdrAddRefDll( 0, ret );
537 else SetLastError( RtlNtStatusToDosError( status ) );
539 if ((flags & GET_MODULE_HANDLE_EX_FLAG_PIN) ||
540 !(flags & GET_MODULE_HANDLE_EX_FLAG_UNCHANGED_REFCOUNT))
541 LdrUnlockLoaderLock( 0, magic );
543 if (module) *module = ret;
544 return (status == STATUS_SUCCESS);
547 /***********************************************************************
548 * GetModuleHandleA (KERNEL32.@)
550 * Get the handle of a dll loaded into the process address space.
552 * PARAMS
553 * module [I] Name of the dll
555 * RETURNS
556 * Success: A handle to the loaded dll.
557 * Failure: A NULL handle. Use GetLastError() to determine the cause.
559 HMODULE WINAPI GetModuleHandleA(LPCSTR module)
561 HMODULE ret;
563 if (!GetModuleHandleExA( GET_MODULE_HANDLE_EX_FLAG_UNCHANGED_REFCOUNT, module, &ret )) ret = 0;
564 return ret;
567 /***********************************************************************
568 * GetModuleHandleW (KERNEL32.@)
570 * Unicode version of GetModuleHandleA.
572 HMODULE WINAPI GetModuleHandleW(LPCWSTR module)
574 HMODULE ret;
576 if (!GetModuleHandleExW( GET_MODULE_HANDLE_EX_FLAG_UNCHANGED_REFCOUNT, module, &ret )) ret = 0;
577 return ret;
581 /***********************************************************************
582 * GetModuleFileNameA (KERNEL32.@)
584 * Get the file name of a loaded module from its handle.
586 * RETURNS
587 * Success: The length of the file name, excluding the terminating NUL.
588 * Failure: 0. Use GetLastError() to determine the cause.
590 * NOTES
591 * This function always returns the long path of hModule
592 * The function doesn't write a terminating '\0' if the buffer is too
593 * small.
595 DWORD WINAPI GetModuleFileNameA(
596 HMODULE hModule, /* [in] Module handle (32 bit) */
597 LPSTR lpFileName, /* [out] Destination for file name */
598 DWORD size ) /* [in] Size of lpFileName in characters */
600 LPWSTR filenameW = HeapAlloc( GetProcessHeap(), 0, size * sizeof(WCHAR) );
601 DWORD len;
603 if (!filenameW)
605 SetLastError( ERROR_NOT_ENOUGH_MEMORY );
606 return 0;
608 if ((len = GetModuleFileNameW( hModule, filenameW, size )))
610 len = FILE_name_WtoA( filenameW, len, lpFileName, size );
611 if (len < size)
612 lpFileName[len] = '\0';
613 else
614 SetLastError( ERROR_INSUFFICIENT_BUFFER );
616 HeapFree( GetProcessHeap(), 0, filenameW );
617 return len;
620 /***********************************************************************
621 * GetModuleFileNameW (KERNEL32.@)
623 * Unicode version of GetModuleFileNameA.
625 DWORD WINAPI GetModuleFileNameW( HMODULE hModule, LPWSTR lpFileName, DWORD size )
627 ULONG magic, len = 0;
628 LDR_MODULE *pldr;
629 NTSTATUS nts;
630 WIN16_SUBSYSTEM_TIB *win16_tib;
632 if (!hModule && ((win16_tib = NtCurrentTeb()->Tib.SubSystemTib)) && win16_tib->exe_name)
634 len = min(size, win16_tib->exe_name->Length / sizeof(WCHAR));
635 memcpy( lpFileName, win16_tib->exe_name->Buffer, len * sizeof(WCHAR) );
636 if (len < size) lpFileName[len] = '\0';
637 goto done;
640 LdrLockLoaderLock( 0, NULL, &magic );
642 if (!hModule) hModule = NtCurrentTeb()->Peb->ImageBaseAddress;
643 nts = LdrFindEntryForAddress( hModule, &pldr );
644 if (nts == STATUS_SUCCESS)
646 len = min(size, pldr->FullDllName.Length / sizeof(WCHAR));
647 memcpy(lpFileName, pldr->FullDllName.Buffer, len * sizeof(WCHAR));
648 if (len < size)
649 lpFileName[len] = '\0';
650 else
651 SetLastError( ERROR_INSUFFICIENT_BUFFER );
653 else SetLastError( RtlNtStatusToDosError( nts ) );
655 LdrUnlockLoaderLock( 0, magic );
656 done:
657 TRACE( "%s\n", debugstr_wn(lpFileName, len) );
658 return len;
662 /***********************************************************************
663 * get_dll_system_path
665 static const WCHAR *get_dll_system_path(void)
667 static WCHAR *cached_path;
669 if (!cached_path)
671 WCHAR *p, *path;
672 int len = 3;
674 len += 2 * GetSystemDirectoryW( NULL, 0 );
675 len += GetWindowsDirectoryW( NULL, 0 );
676 p = path = HeapAlloc( GetProcessHeap(), 0, len * sizeof(WCHAR) );
677 *p++ = '.';
678 *p++ = ';';
679 GetSystemDirectoryW( p, path + len - p);
680 p += strlenW(p);
681 /* if system directory ends in "32" add 16-bit version too */
682 if (p[-2] == '3' && p[-1] == '2')
684 *p++ = ';';
685 GetSystemDirectoryW( p, path + len - p);
686 p += strlenW(p) - 2;
688 *p++ = ';';
689 GetWindowsDirectoryW( p, path + len - p);
690 cached_path = path;
692 return cached_path;
695 /******************************************************************
696 * get_module_path_end
698 * Returns the end of the directory component of the module path.
700 static inline const WCHAR *get_module_path_end(const WCHAR *module)
702 const WCHAR *p;
703 const WCHAR *mod_end = module;
704 if (!module) return mod_end;
706 if ((p = strrchrW( mod_end, '\\' ))) mod_end = p;
707 if ((p = strrchrW( mod_end, '/' ))) mod_end = p;
708 if (mod_end == module + 2 && module[1] == ':') mod_end++;
709 if (mod_end == module && module[0] && module[1] == ':') mod_end += 2;
711 return mod_end;
714 /******************************************************************
715 * MODULE_get_dll_load_path
717 * Compute the load path to use for a given dll.
718 * Returned pointer must be freed by caller.
720 WCHAR *MODULE_get_dll_load_path( LPCWSTR module )
722 static const WCHAR pathW[] = {'P','A','T','H',0};
724 const WCHAR *system_path = get_dll_system_path();
725 const WCHAR *mod_end = NULL;
726 UNICODE_STRING name, value;
727 WCHAR *p, *ret;
728 int len = 0, path_len = 0;
730 /* adjust length for module name */
732 if (module)
733 mod_end = get_module_path_end( module );
734 /* if module is NULL or doesn't contain a path, fall back to directory
735 * process was loaded from */
736 if (module == mod_end)
738 module = NtCurrentTeb()->Peb->ProcessParameters->ImagePathName.Buffer;
739 mod_end = get_module_path_end( module );
741 len += (mod_end - module) + 1;
743 len += strlenW( system_path ) + 2;
745 /* get the PATH variable */
747 RtlInitUnicodeString( &name, pathW );
748 value.Length = 0;
749 value.MaximumLength = 0;
750 value.Buffer = NULL;
751 if (RtlQueryEnvironmentVariable_U( NULL, &name, &value ) == STATUS_BUFFER_TOO_SMALL)
752 path_len = value.Length;
754 RtlEnterCriticalSection( &dlldir_section );
755 if (dll_directory) len += strlenW(dll_directory) + 1;
756 if ((p = ret = HeapAlloc( GetProcessHeap(), 0, path_len + len * sizeof(WCHAR) )))
758 if (module)
760 memcpy( ret, module, (mod_end - module) * sizeof(WCHAR) );
761 p += (mod_end - module);
762 *p++ = ';';
764 if (dll_directory)
766 strcpyW( p, dll_directory );
767 p += strlenW(p);
768 *p++ = ';';
771 RtlLeaveCriticalSection( &dlldir_section );
772 if (!ret) return NULL;
774 strcpyW( p, system_path );
775 p += strlenW(p);
776 *p++ = ';';
777 value.Buffer = p;
778 value.MaximumLength = path_len;
780 while (RtlQueryEnvironmentVariable_U( NULL, &name, &value ) == STATUS_BUFFER_TOO_SMALL)
782 WCHAR *new_ptr;
784 /* grow the buffer and retry */
785 path_len = value.Length;
786 if (!(new_ptr = HeapReAlloc( GetProcessHeap(), 0, ret, path_len + len * sizeof(WCHAR) )))
788 HeapFree( GetProcessHeap(), 0, ret );
789 return NULL;
791 value.Buffer = new_ptr + (value.Buffer - ret);
792 value.MaximumLength = path_len;
793 ret = new_ptr;
795 value.Buffer[value.Length / sizeof(WCHAR)] = 0;
796 return ret;
800 /******************************************************************
801 * load_library_as_datafile
803 static BOOL load_library_as_datafile( LPCWSTR name, HMODULE* hmod)
805 static const WCHAR dotDLL[] = {'.','d','l','l',0};
807 WCHAR filenameW[MAX_PATH];
808 HANDLE hFile = INVALID_HANDLE_VALUE;
809 HANDLE mapping;
810 HMODULE module;
812 *hmod = 0;
814 if (SearchPathW( NULL, name, dotDLL, sizeof(filenameW) / sizeof(filenameW[0]),
815 filenameW, NULL ))
817 hFile = CreateFileW( filenameW, GENERIC_READ, FILE_SHARE_READ,
818 NULL, OPEN_EXISTING, 0, 0 );
820 if (hFile == INVALID_HANDLE_VALUE) return FALSE;
822 mapping = CreateFileMappingW( hFile, NULL, PAGE_READONLY, 0, 0, NULL );
823 CloseHandle( hFile );
824 if (!mapping) return FALSE;
826 module = MapViewOfFile( mapping, FILE_MAP_READ, 0, 0, 0 );
827 CloseHandle( mapping );
828 if (!module) return FALSE;
830 /* make sure it's a valid PE file */
831 if (!RtlImageNtHeader(module))
833 UnmapViewOfFile( module );
834 return FALSE;
836 *hmod = (HMODULE)((char *)module + 1); /* set low bit of handle to indicate datafile module */
837 return TRUE;
841 /******************************************************************
842 * load_library
844 * Helper for LoadLibraryExA/W.
846 static HMODULE load_library( const UNICODE_STRING *libname, DWORD flags )
848 NTSTATUS nts;
849 HMODULE hModule;
850 WCHAR *load_path;
852 load_path = MODULE_get_dll_load_path( flags & LOAD_WITH_ALTERED_SEARCH_PATH ? libname->Buffer : NULL );
854 if (flags & LOAD_LIBRARY_AS_DATAFILE)
856 ULONG magic;
858 LdrLockLoaderLock( 0, NULL, &magic );
859 if (!(nts = LdrGetDllHandle( load_path, flags, libname, &hModule )))
861 LdrAddRefDll( 0, hModule );
862 LdrUnlockLoaderLock( 0, magic );
863 goto done;
865 LdrUnlockLoaderLock( 0, magic );
867 /* The method in load_library_as_datafile allows searching for the
868 * 'native' libraries only
870 if (load_library_as_datafile( libname->Buffer, &hModule )) goto done;
871 flags |= DONT_RESOLVE_DLL_REFERENCES; /* Just in case */
872 /* Fallback to normal behaviour */
875 nts = LdrLoadDll( load_path, flags, libname, &hModule );
876 if (nts != STATUS_SUCCESS)
878 hModule = 0;
879 SetLastError( RtlNtStatusToDosError( nts ) );
881 done:
882 HeapFree( GetProcessHeap(), 0, load_path );
883 return hModule;
887 /******************************************************************
888 * LoadLibraryExA (KERNEL32.@)
890 * Load a dll file into the process address space.
892 * PARAMS
893 * libname [I] Name of the file to load
894 * hfile [I] Reserved, must be 0.
895 * flags [I] Flags for loading the dll
897 * RETURNS
898 * Success: A handle to the loaded dll.
899 * Failure: A NULL handle. Use GetLastError() to determine the cause.
901 * NOTES
902 * The HFILE parameter is not used and marked reserved in the SDK. I can
903 * only guess that it should force a file to be mapped, but I rather
904 * ignore the parameter because it would be extremely difficult to
905 * integrate this with different types of module representations.
907 HMODULE WINAPI DECLSPEC_HOTPATCH LoadLibraryExA(LPCSTR libname, HANDLE hfile, DWORD flags)
909 WCHAR *libnameW;
911 if (!(libnameW = FILE_name_AtoW( libname, FALSE ))) return 0;
912 return LoadLibraryExW( libnameW, hfile, flags );
915 /***********************************************************************
916 * LoadLibraryExW (KERNEL32.@)
918 * Unicode version of LoadLibraryExA.
920 HMODULE WINAPI DECLSPEC_HOTPATCH LoadLibraryExW(LPCWSTR libnameW, HANDLE hfile, DWORD flags)
922 UNICODE_STRING wstr;
923 HMODULE res;
925 if (!libnameW)
927 SetLastError(ERROR_INVALID_PARAMETER);
928 return 0;
930 RtlInitUnicodeString( &wstr, libnameW );
931 if (wstr.Buffer[wstr.Length/sizeof(WCHAR) - 1] != ' ')
932 return load_library( &wstr, flags );
934 /* Library name has trailing spaces */
935 RtlCreateUnicodeString( &wstr, libnameW );
936 while (wstr.Length > sizeof(WCHAR) &&
937 wstr.Buffer[wstr.Length/sizeof(WCHAR) - 1] == ' ')
939 wstr.Length -= sizeof(WCHAR);
941 wstr.Buffer[wstr.Length/sizeof(WCHAR)] = '\0';
942 res = load_library( &wstr, flags );
943 RtlFreeUnicodeString( &wstr );
944 return res;
947 /***********************************************************************
948 * LoadLibraryA (KERNEL32.@)
950 * Load a dll file into the process address space.
952 * PARAMS
953 * libname [I] Name of the file to load
955 * RETURNS
956 * Success: A handle to the loaded dll.
957 * Failure: A NULL handle. Use GetLastError() to determine the cause.
959 * NOTES
960 * See LoadLibraryExA().
962 HMODULE WINAPI DECLSPEC_HOTPATCH LoadLibraryA(LPCSTR libname)
964 return LoadLibraryExA(libname, 0, 0);
967 /***********************************************************************
968 * LoadLibraryW (KERNEL32.@)
970 * Unicode version of LoadLibraryA.
972 HMODULE WINAPI DECLSPEC_HOTPATCH LoadLibraryW(LPCWSTR libnameW)
974 return LoadLibraryExW(libnameW, 0, 0);
977 /***********************************************************************
978 * FreeLibrary (KERNEL32.@)
980 * Free a dll loaded into the process address space.
982 * PARAMS
983 * hLibModule [I] Handle to the dll returned by LoadLibraryA().
985 * RETURNS
986 * Success: TRUE. The dll is removed if it is not still in use.
987 * Failure: FALSE. Use GetLastError() to determine the cause.
989 BOOL WINAPI DECLSPEC_HOTPATCH FreeLibrary(HINSTANCE hLibModule)
991 BOOL retv = FALSE;
992 NTSTATUS nts;
994 if (!hLibModule)
996 SetLastError( ERROR_INVALID_HANDLE );
997 return FALSE;
1000 if ((ULONG_PTR)hLibModule & 1)
1002 /* this is a LOAD_LIBRARY_AS_DATAFILE module */
1003 char *ptr = (char *)hLibModule - 1;
1004 return UnmapViewOfFile( ptr );
1007 if ((nts = LdrUnloadDll( hLibModule )) == STATUS_SUCCESS) retv = TRUE;
1008 else SetLastError( RtlNtStatusToDosError( nts ) );
1010 return retv;
1013 /***********************************************************************
1014 * GetProcAddress (KERNEL32.@)
1016 * Find the address of an exported symbol in a loaded dll.
1018 * PARAMS
1019 * hModule [I] Handle to the dll returned by LoadLibraryA().
1020 * function [I] Name of the symbol, or an integer ordinal number < 16384
1022 * RETURNS
1023 * Success: A pointer to the symbol in the process address space.
1024 * Failure: NULL. Use GetLastError() to determine the cause.
1026 FARPROC WINAPI GetProcAddress( HMODULE hModule, LPCSTR function )
1028 NTSTATUS nts;
1029 FARPROC fp;
1031 if (!hModule) hModule = NtCurrentTeb()->Peb->ImageBaseAddress;
1033 if ((ULONG_PTR)function >> 16)
1035 ANSI_STRING str;
1037 RtlInitAnsiString( &str, function );
1038 nts = LdrGetProcedureAddress( hModule, &str, 0, (void**)&fp );
1040 else
1041 nts = LdrGetProcedureAddress( hModule, NULL, LOWORD(function), (void**)&fp );
1042 if (nts != STATUS_SUCCESS)
1044 SetLastError( RtlNtStatusToDosError( nts ) );
1045 fp = NULL;
1047 return fp;
1050 /***********************************************************************
1051 * DelayLoadFailureHook (KERNEL32.@)
1053 FARPROC WINAPI DelayLoadFailureHook( LPCSTR name, LPCSTR function )
1055 ULONG_PTR args[2];
1057 if ((ULONG_PTR)function >> 16)
1058 ERR( "failed to delay load %s.%s\n", name, function );
1059 else
1060 ERR( "failed to delay load %s.%u\n", name, LOWORD(function) );
1061 args[0] = (ULONG_PTR)name;
1062 args[1] = (ULONG_PTR)function;
1063 RaiseException( EXCEPTION_WINE_STUB, EH_NONCONTINUABLE, 2, args );
1064 return NULL;
1068 #ifdef __i386__
1070 /***********************************************************************
1071 * __wine_dll_register_16 (KERNEL32.@)
1073 * No longer used.
1075 void __wine_dll_register_16( const IMAGE_DOS_HEADER *header, const char *file_name )
1077 ERR( "loading old style 16-bit dll %s no longer supported\n", file_name );
1081 /***********************************************************************
1082 * __wine_dll_unregister_16 (KERNEL32.@)
1084 * No longer used.
1086 void __wine_dll_unregister_16( const IMAGE_DOS_HEADER *header )
1090 #endif