git.oblomov.eu Git - wine/blob - dlls/kernel32/virtual.c

   1 /*
   2  * Win32 virtual memory functions
   3  *
   4  * Copyright 1997 Alexandre Julliard
   5  *
   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.
  10  *
  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.
  15  *
  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
  19  */
  20
  21 #include "config.h"
  22 #include "wine/port.h"
  23
  24 #include <fcntl.h>
  25 #include <stdarg.h>
  26 #include <stdlib.h>
  27 #include <string.h>
  28 #include <sys/types.h>
  29 #ifdef HAVE_UNISTD_H
  30 # include <unistd.h>
  31 #endif
  32
  33 #define NONAMELESSUNION
  34 #define NONAMELESSSTRUCT
  35 #include "ntstatus.h"
  36 #define WIN32_NO_STATUS
  37 #include "windef.h"
  38 #include "winbase.h"
  39 #include "winnls.h"
  40 #include "winternl.h"
  41 #include "winerror.h"
  42 #include "wine/exception.h"
  43 #include "wine/debug.h"
  44
  45 #include "kernel_private.h"
  46
  47 WINE_DECLARE_DEBUG_CHANNEL(seh);
  48
  49 static unsigned int page_size;
  50
  51
  52 /***********************************************************************
  53  *             VirtualAlloc   (KERNEL32.@)
  54  *
  55  * Reserves or commits a region of pages in virtual address space.
  56  *
  57  * PARAMS
  58  *  addr    [I] Address of region to reserve or commit.
  59  *  size    [I] Size of region.
  60  *  type    [I] Type of allocation.
  61  *  protect [I] Type of access protection.
  62  *
  63  * RETURNS
  64  *      Success: Base address of allocated region of pages.
  65  *      Failure: NULL.
  66  */
  67 LPVOID WINAPI VirtualAlloc( LPVOID addr, SIZE_T size, DWORD type, DWORD protect )
  68 {
  69     return VirtualAllocEx( GetCurrentProcess(), addr, size, type, protect );
  70 }
  71
  72
  73 /***********************************************************************
  74  *             VirtualAllocEx   (KERNEL32.@)
  75  *
  76  * Seems to be just as VirtualAlloc, but with process handle.
  77  *
  78  * PARAMS
  79  *  hProcess [I] Handle to process to do mem operation.
  80  *  addr     [I] Address of region to reserve or commit.
  81  *  size     [I] Size of region.
  82  *  type     [I] Type of allocation.
  83  *  protect  [I] Type of access protection.
  84  *
  85  *
  86  * RETURNS
  87  *      Success: Base address of allocated region of pages.
  88  *      Failure: NULL.
  89  */
  90 LPVOID WINAPI VirtualAllocEx( HANDLE hProcess, LPVOID addr, SIZE_T size,
  91     DWORD type, DWORD protect )
  92 {
  93     LPVOID ret = addr;
  94     NTSTATUS status;
  95
  96     if ((status = NtAllocateVirtualMemory( hProcess, &ret, 0, &size, type, protect )))
  97     {
  98         SetLastError( RtlNtStatusToDosError(status) );
  99         ret = NULL;
 100     }
 101     return ret;
 102 }
 103
 104
 105 /***********************************************************************
 106  *             VirtualFree   (KERNEL32.@)
 107  *
 108  * Releases or decommits a region of pages in virtual address space.
 109  *
 110  * PARAMS
 111  *  addr [I] Address of region of committed pages.
 112  *  size [I] Size of region.
 113  *  type [I] Type of operation.
 114  *
 115  * RETURNS
 116  *      Success: TRUE.
 117  *      Failure: FALSE.
 118  */
 119 BOOL WINAPI VirtualFree( LPVOID addr, SIZE_T size, DWORD type )
 120 {
 121     return VirtualFreeEx( GetCurrentProcess(), addr, size, type );
 122 }
 123
 124
 125 /***********************************************************************
 126  *             VirtualFreeEx   (KERNEL32.@)
 127  *
 128  * Releases or decommits a region of pages in virtual address space.
 129  *
 130  * PARAMS
 131  *  process [I] Handle to process.
 132  *  addr    [I] Address of region to free.
 133  *  size    [I] Size of region.
 134  *  type    [I] Type of operation.
 135  *
 136  * RETURNS
 137  *      Success: TRUE.
 138  *      Failure: FALSE.
 139  */
 140 BOOL WINAPI VirtualFreeEx( HANDLE process, LPVOID addr, SIZE_T size, DWORD type )
 141 {
 142     NTSTATUS status = NtFreeVirtualMemory( process, &addr, &size, type );
 143     if (status) SetLastError( RtlNtStatusToDosError(status) );
 144     return !status;
 145 }
 146
 147
 148 /***********************************************************************
 149  *             VirtualLock   (KERNEL32.@)
 150  *
 151  * Locks the specified region of virtual address space.
 152  *
 153  * PARAMS
 154  *  addr [I] Address of first byte of range to lock.
 155  *  size [I] Number of bytes in range to lock.
 156  *
 157  * RETURNS
 158  *      Success: TRUE.
 159  *      Failure: FALSE.
 160  *
 161  * NOTES
 162  *      Always returns TRUE.
 163  *
 164  */
 165 BOOL WINAPI VirtualLock( LPVOID addr, SIZE_T size )
 166 {
 167     NTSTATUS status = NtLockVirtualMemory( GetCurrentProcess(), &addr, &size, 1 );
 168     if (status) SetLastError( RtlNtStatusToDosError(status) );
 169     return !status;
 170 }
 171
 172
 173 /***********************************************************************
 174  *             VirtualUnlock   (KERNEL32.@)
 175  *
 176  * Unlocks a range of pages in the virtual address space.
 177  *
 178  * PARAMS
 179  *  addr [I] Address of first byte of range.
 180  *  size [I] Number of bytes in range.
 181  *
 182  * RETURNS
 183  *      Success: TRUE.
 184  *      Failure: FALSE.
 185  *
 186  * NOTES
 187  *      Always returns TRUE.
 188  *
 189  */
 190 BOOL WINAPI VirtualUnlock( LPVOID addr, SIZE_T size )
 191 {
 192     NTSTATUS status = NtUnlockVirtualMemory( GetCurrentProcess(), &addr, &size, 1 );
 193     if (status) SetLastError( RtlNtStatusToDosError(status) );
 194     return !status;
 195 }
 196
 197
 198 /***********************************************************************
 199  *             VirtualProtect   (KERNEL32.@)
 200  *
 201  * Changes the access protection on a region of committed pages.
 202  *
 203  * PARAMS
 204  *  addr     [I] Address of region of committed pages.
 205  *  size     [I] Size of region.
 206  *  new_prot [I] Desired access protection.
 207  *  old_prot [O] Address of variable to get old protection.
 208  *
 209  * RETURNS
 210  *      Success: TRUE.
 211  *      Failure: FALSE.
 212  */
 213 BOOL WINAPI VirtualProtect( LPVOID addr, SIZE_T size, DWORD new_prot, LPDWORD old_prot)
 214 {
 215     return VirtualProtectEx( GetCurrentProcess(), addr, size, new_prot, old_prot );
 216 }
 217
 218
 219 /***********************************************************************
 220  *             VirtualProtectEx   (KERNEL32.@)
 221  *
 222  * Changes the access protection on a region of committed pages in the
 223  * virtual address space of a specified process.
 224  *
 225  * PARAMS
 226  *  process  [I] Handle of process.
 227  *  addr     [I] Address of region of committed pages.
 228  *  size     [I] Size of region.
 229  *  new_prot [I] Desired access protection.
 230  *  old_prot [O] Address of variable to get old protection.
 231  *
 232  * RETURNS
 233  *      Success: TRUE.
 234  *      Failure: FALSE.
 235  */
 236 BOOL WINAPI VirtualProtectEx( HANDLE process, LPVOID addr, SIZE_T size,
 237     DWORD new_prot, LPDWORD old_prot )
 238 {
 239     NTSTATUS status = NtProtectVirtualMemory( process, &addr, &size, new_prot, old_prot );
 240     if (status) SetLastError( RtlNtStatusToDosError(status) );
 241     return !status;
 242 }
 243
 244
 245 /***********************************************************************
 246  *             VirtualQuery   (KERNEL32.@)
 247  *
 248  * Provides info about a range of pages in virtual address space.
 249  *
 250  * PARAMS
 251  *  addr [I] Address of region.
 252  *  info [O] Address of info buffer.
 253  *  len  [I] Size of buffer.
 254  *
 255  * RETURNS
 256  *      Number of bytes returned in information buffer or 0 if
 257  *      addr >= 0xc0000000 (kernel space).
 258  */
 259 SIZE_T WINAPI VirtualQuery( LPCVOID addr, PMEMORY_BASIC_INFORMATION info,
 260     SIZE_T len )
 261 {
 262     return VirtualQueryEx( GetCurrentProcess(), addr, info, len );
 263 }
 264
 265
 266 /***********************************************************************
 267  *             VirtualQueryEx   (KERNEL32.@)
 268  *
 269  * Provides info about a range of pages in virtual address space of a
 270  * specified process.
 271  *
 272  * PARAMS
 273  *  process [I] Handle to process.
 274  *  addr    [I] Address of region.
 275  *  info    [O] Address of info buffer.
 276  *  len     [I] Size of buffer.
 277  *
 278  * RETURNS
 279  *      Number of bytes returned in information buffer.
 280  */
 281 SIZE_T WINAPI VirtualQueryEx( HANDLE process, LPCVOID addr,
 282     PMEMORY_BASIC_INFORMATION info, SIZE_T len )
 283 {
 284     SIZE_T ret;
 285     NTSTATUS status;
 286
 287     if ((status = NtQueryVirtualMemory( process, addr, MemoryBasicInformation, info, len, &ret )))
 288     {
 289         SetLastError( RtlNtStatusToDosError(status) );
 290         ret = 0;
 291     }
 292     return ret;
 293 }
 294
 295
 296 /***********************************************************************
 297  *             CreateFileMappingA   (KERNEL32.@)
 298  *
 299  * Creates a named or unnamed file-mapping object for the specified file.
 300  *
 301  * PARAMS
 302  *  hFile     [I] Handle to the file to map.
 303  *  sa        [I] Optional security attributes.
 304  *  protect   [I] Protection for mapping object.
 305  *  size_high [I] High-order 32 bits of object size.
 306  *  size_low  [I] Low-order 32 bits of object size.
 307  *  name      [I] Name of file-mapping object.
 308  *
 309  * RETURNS
 310  *      Success: Handle.
 311  *      Failure: NULL. Mapping object does not exist.
 312  */
 313 HANDLE WINAPI CreateFileMappingA( HANDLE hFile, SECURITY_ATTRIBUTES *sa,
 314     DWORD protect, DWORD size_high, DWORD size_low, LPCSTR name )
 315 {
 316     WCHAR buffer[MAX_PATH];
 317
 318     if (!name) return CreateFileMappingW( hFile, sa, protect, size_high, size_low, NULL );
 319
 320     if (!MultiByteToWideChar( CP_ACP, 0, name, -1, buffer, MAX_PATH ))
 321     {
 322         SetLastError( ERROR_FILENAME_EXCED_RANGE );
 323         return 0;
 324     }
 325     return CreateFileMappingW( hFile, sa, protect, size_high, size_low, buffer );
 326 }
 327
 328
 329 /***********************************************************************
 330  *             CreateFileMappingW   (KERNEL32.@)
 331  *
 332  * See CreateFileMappingA.
 333  */
 334 HANDLE WINAPI CreateFileMappingW( HANDLE hFile, LPSECURITY_ATTRIBUTES sa,
 335                                   DWORD protect, DWORD size_high,
 336                                   DWORD size_low, LPCWSTR name )
 337 {
 338     static const int sec_flags = SEC_FILE | SEC_IMAGE | SEC_RESERVE | SEC_COMMIT | SEC_NOCACHE;
 339
 340     HANDLE ret;
 341     OBJECT_ATTRIBUTES attr;
 342     UNICODE_STRING nameW;
 343     NTSTATUS status;
 344     DWORD access, sec_type;
 345     LARGE_INTEGER size;
 346
 347     attr.Length                   = sizeof(attr);
 348     attr.RootDirectory            = 0;
 349     attr.ObjectName               = NULL;
 350     attr.Attributes               = OBJ_OPENIF | ((sa && sa->bInheritHandle) ? OBJ_INHERIT : 0);
 351     attr.SecurityDescriptor       = sa ? sa->lpSecurityDescriptor : NULL;
 352     attr.SecurityQualityOfService = NULL;
 353
 354     if (name)
 355     {
 356         RtlInitUnicodeString( &nameW, name );
 357         attr.ObjectName = &nameW;
 358         attr.RootDirectory = get_BaseNamedObjects_handle();
 359     }
 360
 361     sec_type = protect & sec_flags;
 362     protect &= ~sec_flags;
 363     if (!sec_type) sec_type = SEC_COMMIT;
 364
 365     switch(protect)
 366     {
 367     case 0:
 368         protect = PAGE_READONLY;  /* Win9x compatibility */
 369         /* fall through */
 370     case PAGE_READONLY:
 371     case PAGE_WRITECOPY:
 372         access = STANDARD_RIGHTS_REQUIRED | SECTION_QUERY | SECTION_MAP_READ;
 373         break;
 374     case PAGE_READWRITE:
 375         access = STANDARD_RIGHTS_REQUIRED | SECTION_QUERY | SECTION_MAP_READ | SECTION_MAP_WRITE;
 376         break;
 377     default:
 378         SetLastError( ERROR_INVALID_PARAMETER );
 379         return 0;
 380     }
 381
 382     if (hFile == INVALID_HANDLE_VALUE)
 383     {
 384         hFile = 0;
 385         if (!size_low && !size_high)
 386         {
 387             SetLastError( ERROR_INVALID_PARAMETER );
 388             return 0;
 389         }
 390     }
 391
 392     size.u.LowPart  = size_low;
 393     size.u.HighPart = size_high;
 394
 395     status = NtCreateSection( &ret, access, &attr, &size, protect, sec_type, hFile );
 396     if (status == STATUS_OBJECT_NAME_EXISTS)
 397         SetLastError( ERROR_ALREADY_EXISTS );
 398     else
 399         SetLastError( RtlNtStatusToDosError(status) );
 400     return ret;
 401 }
 402
 403
 404 /***********************************************************************
 405  *             OpenFileMappingA   (KERNEL32.@)
 406  *
 407  * Opens a named file-mapping object.
 408  *
 409  * PARAMS
 410  *  access  [I] Access mode.
 411  *  inherit [I] Inherit flag.
 412  *  name    [I] Name of file-mapping object.
 413  *
 414  * RETURNS
 415  *      Success: Handle.
 416  *      Failure: NULL.
 417  */
 418 HANDLE WINAPI OpenFileMappingA( DWORD access, BOOL inherit, LPCSTR name )
 419 {
 420     WCHAR buffer[MAX_PATH];
 421
 422     if (!name) return OpenFileMappingW( access, inherit, NULL );
 423
 424     if (!MultiByteToWideChar( CP_ACP, 0, name, -1, buffer, MAX_PATH ))
 425     {
 426         SetLastError( ERROR_FILENAME_EXCED_RANGE );
 427         return 0;
 428     }
 429     return OpenFileMappingW( access, inherit, buffer );
 430 }
 431
 432
 433 /***********************************************************************
 434  *             OpenFileMappingW   (KERNEL32.@)
 435  *
 436  * See OpenFileMappingA.
 437  */
 438 HANDLE WINAPI OpenFileMappingW( DWORD access, BOOL inherit, LPCWSTR name)
 439 {
 440     OBJECT_ATTRIBUTES attr;
 441     UNICODE_STRING nameW;
 442     HANDLE ret;
 443     NTSTATUS status;
 444
 445     if (!name)
 446     {
 447         SetLastError( ERROR_INVALID_PARAMETER );
 448         return 0;
 449     }
 450     attr.Length = sizeof(attr);
 451     attr.RootDirectory = get_BaseNamedObjects_handle();
 452     attr.ObjectName = &nameW;
 453     attr.Attributes = inherit ? OBJ_INHERIT : 0;
 454     attr.SecurityDescriptor = NULL;
 455     attr.SecurityQualityOfService = NULL;
 456     RtlInitUnicodeString( &nameW, name );
 457
 458     if (access == FILE_MAP_COPY) access = FILE_MAP_READ;
 459
 460     if ((status = NtOpenSection( &ret, access, &attr )))
 461     {
 462         SetLastError( RtlNtStatusToDosError(status) );
 463         ret = 0;
 464     }
 465     return ret;
 466 }
 467
 468
 469 /***********************************************************************
 470  *             MapViewOfFile   (KERNEL32.@)
 471  *
 472  * Maps a view of a file into the address space.
 473  *
 474  * PARAMS
 475  *  mapping     [I] File-mapping object to map.
 476  *  access      [I] Access mode.
 477  *  offset_high [I] High-order 32 bits of file offset.
 478  *  offset_low  [I] Low-order 32 bits of file offset.
 479  *  count       [I] Number of bytes to map.
 480  *
 481  * RETURNS
 482  *      Success: Starting address of mapped view.
 483  *      Failure: NULL.
 484  */
 485 LPVOID WINAPI MapViewOfFile( HANDLE mapping, DWORD access,
 486     DWORD offset_high, DWORD offset_low, SIZE_T count )
 487 {
 488     return MapViewOfFileEx( mapping, access, offset_high,
 489                             offset_low, count, NULL );
 490 }
 491
 492
 493 /***********************************************************************
 494  *             MapViewOfFileEx   (KERNEL32.@)
 495  *
 496  * Maps a view of a file into the address space.
 497  *
 498  * PARAMS
 499  *  handle      [I] File-mapping object to map.
 500  *  access      [I] Access mode.
 501  *  offset_high [I] High-order 32 bits of file offset.
 502  *  offset_low  [I] Low-order 32 bits of file offset.
 503  *  count       [I] Number of bytes to map.
 504  *  addr        [I] Suggested starting address for mapped view.
 505  *
 506  * RETURNS
 507  *      Success: Starting address of mapped view.
 508  *      Failure: NULL.
 509  */
 510 LPVOID WINAPI MapViewOfFileEx( HANDLE handle, DWORD access,
 511     DWORD offset_high, DWORD offset_low, SIZE_T count, LPVOID addr )
 512 {
 513     NTSTATUS status;
 514     LARGE_INTEGER offset;
 515     ULONG protect;
 516
 517     offset.u.LowPart  = offset_low;
 518     offset.u.HighPart = offset_high;
 519
 520     if (access & FILE_MAP_WRITE) protect = PAGE_READWRITE;
 521     else if (access & FILE_MAP_READ) protect = PAGE_READONLY;
 522     else if (access & FILE_MAP_COPY) protect = PAGE_WRITECOPY;
 523     else protect = PAGE_NOACCESS;
 524
 525     if ((status = NtMapViewOfSection( handle, GetCurrentProcess(), &addr, 0, 0, &offset,
 526                                       &count, ViewShare, 0, protect )))
 527     {
 528         SetLastError( RtlNtStatusToDosError(status) );
 529         addr = NULL;
 530     }
 531     return addr;
 532 }
 533
 534
 535 /***********************************************************************
 536  *             UnmapViewOfFile   (KERNEL32.@)
 537  *
 538  * Unmaps a mapped view of a file.
 539  *
 540  * PARAMS
 541  *  addr [I] Address where mapped view begins.
 542  *
 543  * RETURNS
 544  *      Success: TRUE.
 545  *      Failure: FALSE.
 546  *
 547  */
 548 BOOL WINAPI UnmapViewOfFile( LPCVOID addr )
 549 {
 550     NTSTATUS status = NtUnmapViewOfSection( GetCurrentProcess(), (void *)addr );
 551     if (status) SetLastError( RtlNtStatusToDosError(status) );
 552     return !status;
 553 }
 554
 555
 556 /***********************************************************************
 557  *             FlushViewOfFile   (KERNEL32.@)
 558  *
 559  * Writes to the disk a byte range within a mapped view of a file.
 560  *
 561  * PARAMS
 562  *  base [I] Start address of byte range to flush.
 563  *  size [I] Number of bytes in range.
 564  *
 565  * RETURNS
 566  *      Success: TRUE.
 567  *      Failure: FALSE.
 568  */
 569 BOOL WINAPI FlushViewOfFile( LPCVOID base, SIZE_T size )
 570 {
 571     NTSTATUS status = NtFlushVirtualMemory( GetCurrentProcess(), &base, &size, 0 );
 572     if (status)
 573     {
 574         if (status == STATUS_NOT_MAPPED_DATA) status = STATUS_SUCCESS;
 575         else SetLastError( RtlNtStatusToDosError(status) );
 576     }
 577     return !status;
 578 }
 579
 580
 581 /***********************************************************************
 582  *             IsBadReadPtr   (KERNEL32.@)
 583  *
 584  * Check for read access on a memory block.
 585  *
 586  * ptr  [I] Address of memory block.
 587  * size [I] Size of block.
 588  *
 589  * RETURNS
 590  *  Success: TRUE.
 591  *      Failure: FALSE. Process has read access to entire block.
 592  */
 593 BOOL WINAPI IsBadReadPtr( LPCVOID ptr, UINT size )
 594 {
 595     if (!size) return FALSE;  /* handle 0 size case w/o reference */
 596     if (!ptr) return TRUE;
 597
 598     if (!page_size) page_size = getpagesize();
 599     __TRY
 600     {
 601         volatile const char *p = ptr;
 602         char dummy;
 603         UINT count = size;
 604
 605         while (count > page_size)
 606         {
 607             dummy = *p;
 608             p += page_size;
 609             count -= page_size;
 610         }
 611         dummy = p[0];
 612         dummy = p[count - 1];
 613     }
 614     __EXCEPT_PAGE_FAULT
 615     {
 616         TRACE_(seh)("%p caused page fault during read\n", ptr);
 617         return TRUE;
 618     }
 619     __ENDTRY
 620     return FALSE;
 621 }
 622
 623
 624 /***********************************************************************
 625  *             IsBadWritePtr   (KERNEL32.@)
 626  *
 627  * Check for write access on a memory block.
 628  *
 629  * PARAMS
 630  *  ptr  [I] Address of memory block.
 631  *  size [I] Size of block in bytes.
 632  *
 633  * RETURNS
 634  *  Success: TRUE.
 635  *      Failure: FALSE. Process has write access to entire block.
 636  */
 637 BOOL WINAPI IsBadWritePtr( LPVOID ptr, UINT size )
 638 {
 639     if (!size) return FALSE;  /* handle 0 size case w/o reference */
 640     if (!ptr) return TRUE;
 641
 642     if (!page_size) page_size = getpagesize();
 643     __TRY
 644     {
 645         volatile char *p = ptr;
 646         UINT count = size;
 647
 648         while (count > page_size)
 649         {
 650             *p |= 0;
 651             p += page_size;
 652             count -= page_size;
 653         }
 654         p[0] |= 0;
 655         p[count - 1] |= 0;
 656     }
 657     __EXCEPT_PAGE_FAULT
 658     {
 659         TRACE_(seh)("%p caused page fault during write\n", ptr);
 660         return TRUE;
 661     }
 662     __ENDTRY
 663     return FALSE;
 664 }
 665
 666
 667 /***********************************************************************
 668  *             IsBadHugeReadPtr   (KERNEL32.@)
 669  *
 670  * Check for read access on a memory block.
 671  *
 672  * PARAMS
 673  *  ptr  [I] Address of memory block.
 674  *  size [I] Size of block.
 675  *
 676  * RETURNS
 677  *  Success: TRUE.
 678  *      Failure: FALSE. Process has read access to entire block.
 679  */
 680 BOOL WINAPI IsBadHugeReadPtr( LPCVOID ptr, UINT size )
 681 {
 682     return IsBadReadPtr( ptr, size );
 683 }
 684
 685
 686 /***********************************************************************
 687  *             IsBadHugeWritePtr   (KERNEL32.@)
 688  *
 689  * Check for write access on a memory block.
 690  *
 691  * PARAMS
 692  *  ptr  [I] Address of memory block.
 693  *  size [I] Size of block.
 694  *
 695  * RETURNS
 696  *  Success: TRUE.
 697  *      Failure: FALSE. Process has write access to entire block.
 698  */
 699 BOOL WINAPI IsBadHugeWritePtr( LPVOID ptr, UINT size )
 700 {
 701     return IsBadWritePtr( ptr, size );
 702 }
 703
 704
 705 /***********************************************************************
 706  *             IsBadCodePtr   (KERNEL32.@)
 707  *
 708  * Check for read access on a memory address.
 709  *
 710  * PARAMS
 711  *  ptr [I] Address of function.
 712  *
 713  * RETURNS
 714  *      Success: TRUE.
 715  *      Failure: FALSE. Process has read access to specified memory.
 716  */
 717 BOOL WINAPI IsBadCodePtr( FARPROC ptr )
 718 {
 719     return IsBadReadPtr( ptr, 1 );
 720 }
 721
 722
 723 /***********************************************************************
 724  *             IsBadStringPtrA   (KERNEL32.@)
 725  *
 726  * Check for read access on a range of memory pointed to by a string pointer.
 727  *
 728  * PARAMS
 729  *  str [I] Address of string.
 730  *  max [I] Maximum size of string.
 731  *
 732  * RETURNS
 733  *      Success: TRUE.
 734  *      Failure: FALSE. Read access to all bytes in string.
 735  */
 736 BOOL WINAPI IsBadStringPtrA( LPCSTR str, UINT max )
 737 {
 738     if (!str) return TRUE;
 739
 740     __TRY
 741     {
 742         volatile const char *p = str;
 743         while (p != str + max) if (!*p++) break;
 744     }
 745     __EXCEPT_PAGE_FAULT
 746     {
 747         TRACE_(seh)("%p caused page fault during read\n", str);
 748         return TRUE;
 749     }
 750     __ENDTRY
 751     return FALSE;
 752 }
 753
 754
 755 /***********************************************************************
 756  *             IsBadStringPtrW   (KERNEL32.@)
 757  *
 758  * See IsBadStringPtrA.
 759  */
 760 BOOL WINAPI IsBadStringPtrW( LPCWSTR str, UINT max )
 761 {
 762     if (!str) return TRUE;
 763
 764     __TRY
 765     {
 766         volatile const WCHAR *p = str;
 767         while (p != str + max) if (!*p++) break;
 768     }
 769     __EXCEPT_PAGE_FAULT
 770     {
 771         TRACE_(seh)("%p caused page fault during read\n", str);
 772         return TRUE;
 773     }
 774     __ENDTRY
 775     return FALSE;
 776 }