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     case PAGE_EXECUTE:
 378         access = STANDARD_RIGHTS_REQUIRED | SECTION_QUERY | SECTION_MAP_EXECUTE;
 379         break;
 380     case PAGE_EXECUTE_READ:
 381     case PAGE_EXECUTE_WRITECOPY:
 382         access = STANDARD_RIGHTS_REQUIRED | SECTION_QUERY | SECTION_MAP_READ | SECTION_MAP_EXECUTE;
 383         break;
 384     case PAGE_EXECUTE_READWRITE:
 385         access = STANDARD_RIGHTS_REQUIRED | SECTION_QUERY | SECTION_MAP_READ | SECTION_MAP_WRITE | SECTION_MAP_EXECUTE;
 386         break;
 387     default:
 388         SetLastError( ERROR_INVALID_PARAMETER );
 389         return 0;
 390     }
 391
 392     if (hFile == INVALID_HANDLE_VALUE)
 393     {
 394         hFile = 0;
 395         if (!size_low && !size_high)
 396         {
 397             SetLastError( ERROR_INVALID_PARAMETER );
 398             return 0;
 399         }
 400     }
 401
 402     size.u.LowPart  = size_low;
 403     size.u.HighPart = size_high;
 404
 405     status = NtCreateSection( &ret, access, &attr, &size, protect, sec_type, hFile );
 406     if (status == STATUS_OBJECT_NAME_EXISTS)
 407         SetLastError( ERROR_ALREADY_EXISTS );
 408     else
 409         SetLastError( RtlNtStatusToDosError(status) );
 410     return ret;
 411 }
 412
 413
 414 /***********************************************************************
 415  *             OpenFileMappingA   (KERNEL32.@)
 416  *
 417  * Opens a named file-mapping object.
 418  *
 419  * PARAMS
 420  *  access  [I] Access mode.
 421  *  inherit [I] Inherit flag.
 422  *  name    [I] Name of file-mapping object.
 423  *
 424  * RETURNS
 425  *      Success: Handle.
 426  *      Failure: NULL.
 427  */
 428 HANDLE WINAPI OpenFileMappingA( DWORD access, BOOL inherit, LPCSTR name )
 429 {
 430     WCHAR buffer[MAX_PATH];
 431
 432     if (!name) return OpenFileMappingW( access, inherit, NULL );
 433
 434     if (!MultiByteToWideChar( CP_ACP, 0, name, -1, buffer, MAX_PATH ))
 435     {
 436         SetLastError( ERROR_FILENAME_EXCED_RANGE );
 437         return 0;
 438     }
 439     return OpenFileMappingW( access, inherit, buffer );
 440 }
 441
 442
 443 /***********************************************************************
 444  *             OpenFileMappingW   (KERNEL32.@)
 445  *
 446  * See OpenFileMappingA.
 447  */
 448 HANDLE WINAPI OpenFileMappingW( DWORD access, BOOL inherit, LPCWSTR name)
 449 {
 450     OBJECT_ATTRIBUTES attr;
 451     UNICODE_STRING nameW;
 452     HANDLE ret;
 453     NTSTATUS status;
 454
 455     if (!name)
 456     {
 457         SetLastError( ERROR_INVALID_PARAMETER );
 458         return 0;
 459     }
 460     attr.Length = sizeof(attr);
 461     attr.RootDirectory = get_BaseNamedObjects_handle();
 462     attr.ObjectName = &nameW;
 463     attr.Attributes = inherit ? OBJ_INHERIT : 0;
 464     attr.SecurityDescriptor = NULL;
 465     attr.SecurityQualityOfService = NULL;
 466     RtlInitUnicodeString( &nameW, name );
 467
 468     if (access == FILE_MAP_COPY) access = FILE_MAP_READ;
 469
 470     if ((status = NtOpenSection( &ret, access, &attr )))
 471     {
 472         SetLastError( RtlNtStatusToDosError(status) );
 473         ret = 0;
 474     }
 475     return ret;
 476 }
 477
 478
 479 /***********************************************************************
 480  *             MapViewOfFile   (KERNEL32.@)
 481  *
 482  * Maps a view of a file into the address space.
 483  *
 484  * PARAMS
 485  *  mapping     [I] File-mapping object to map.
 486  *  access      [I] Access mode.
 487  *  offset_high [I] High-order 32 bits of file offset.
 488  *  offset_low  [I] Low-order 32 bits of file offset.
 489  *  count       [I] Number of bytes to map.
 490  *
 491  * RETURNS
 492  *      Success: Starting address of mapped view.
 493  *      Failure: NULL.
 494  */
 495 LPVOID WINAPI MapViewOfFile( HANDLE mapping, DWORD access,
 496     DWORD offset_high, DWORD offset_low, SIZE_T count )
 497 {
 498     return MapViewOfFileEx( mapping, access, offset_high,
 499                             offset_low, count, NULL );
 500 }
 501
 502
 503 /***********************************************************************
 504  *             MapViewOfFileEx   (KERNEL32.@)
 505  *
 506  * Maps a view of a file into the address space.
 507  *
 508  * PARAMS
 509  *  handle      [I] File-mapping object to map.
 510  *  access      [I] Access mode.
 511  *  offset_high [I] High-order 32 bits of file offset.
 512  *  offset_low  [I] Low-order 32 bits of file offset.
 513  *  count       [I] Number of bytes to map.
 514  *  addr        [I] Suggested starting address for mapped view.
 515  *
 516  * RETURNS
 517  *      Success: Starting address of mapped view.
 518  *      Failure: NULL.
 519  */
 520 LPVOID WINAPI MapViewOfFileEx( HANDLE handle, DWORD access,
 521     DWORD offset_high, DWORD offset_low, SIZE_T count, LPVOID addr )
 522 {
 523     NTSTATUS status;
 524     LARGE_INTEGER offset;
 525     ULONG protect;
 526
 527     offset.u.LowPart  = offset_low;
 528     offset.u.HighPart = offset_high;
 529
 530     if (access & FILE_MAP_WRITE) protect = PAGE_READWRITE;
 531     else if (access & FILE_MAP_READ) protect = PAGE_READONLY;
 532     else if (access & FILE_MAP_COPY) protect = PAGE_WRITECOPY;
 533     else protect = PAGE_NOACCESS;
 534
 535     if ((status = NtMapViewOfSection( handle, GetCurrentProcess(), &addr, 0, 0, &offset,
 536                                       &count, ViewShare, 0, protect )))
 537     {
 538         SetLastError( RtlNtStatusToDosError(status) );
 539         addr = NULL;
 540     }
 541     return addr;
 542 }
 543
 544
 545 /***********************************************************************
 546  *             UnmapViewOfFile   (KERNEL32.@)
 547  *
 548  * Unmaps a mapped view of a file.
 549  *
 550  * PARAMS
 551  *  addr [I] Address where mapped view begins.
 552  *
 553  * RETURNS
 554  *      Success: TRUE.
 555  *      Failure: FALSE.
 556  *
 557  */
 558 BOOL WINAPI UnmapViewOfFile( LPCVOID addr )
 559 {
 560     NTSTATUS status = NtUnmapViewOfSection( GetCurrentProcess(), (void *)addr );
 561     if (status) SetLastError( RtlNtStatusToDosError(status) );
 562     return !status;
 563 }
 564
 565
 566 /***********************************************************************
 567  *             FlushViewOfFile   (KERNEL32.@)
 568  *
 569  * Writes to the disk a byte range within a mapped view of a file.
 570  *
 571  * PARAMS
 572  *  base [I] Start address of byte range to flush.
 573  *  size [I] Number of bytes in range.
 574  *
 575  * RETURNS
 576  *      Success: TRUE.
 577  *      Failure: FALSE.
 578  */
 579 BOOL WINAPI FlushViewOfFile( LPCVOID base, SIZE_T size )
 580 {
 581     NTSTATUS status = NtFlushVirtualMemory( GetCurrentProcess(), &base, &size, 0 );
 582     if (status)
 583     {
 584         if (status == STATUS_NOT_MAPPED_DATA) status = STATUS_SUCCESS;
 585         else SetLastError( RtlNtStatusToDosError(status) );
 586     }
 587     return !status;
 588 }
 589
 590
 591 /***********************************************************************
 592  *             IsBadReadPtr   (KERNEL32.@)
 593  *
 594  * Check for read access on a memory block.
 595  *
 596  * ptr  [I] Address of memory block.
 597  * size [I] Size of block.
 598  *
 599  * RETURNS
 600  *  Success: TRUE.
 601  *      Failure: FALSE. Process has read access to entire block.
 602  */
 603 BOOL WINAPI IsBadReadPtr( LPCVOID ptr, UINT size )
 604 {
 605     if (!size) return FALSE;  /* handle 0 size case w/o reference */
 606     if (!ptr) return TRUE;
 607
 608     if (!page_size) page_size = getpagesize();
 609     __TRY
 610     {
 611         volatile const char *p = ptr;
 612         char dummy;
 613         UINT count = size;
 614
 615         while (count > page_size)
 616         {
 617             dummy = *p;
 618             p += page_size;
 619             count -= page_size;
 620         }
 621         dummy = p[0];
 622         dummy = p[count - 1];
 623     }
 624     __EXCEPT_PAGE_FAULT
 625     {
 626         TRACE_(seh)("%p caused page fault during read\n", ptr);
 627         return TRUE;
 628     }
 629     __ENDTRY
 630     return FALSE;
 631 }
 632
 633
 634 /***********************************************************************
 635  *             IsBadWritePtr   (KERNEL32.@)
 636  *
 637  * Check for write access on a memory block.
 638  *
 639  * PARAMS
 640  *  ptr  [I] Address of memory block.
 641  *  size [I] Size of block in bytes.
 642  *
 643  * RETURNS
 644  *  Success: TRUE.
 645  *      Failure: FALSE. Process has write access to entire block.
 646  */
 647 BOOL WINAPI IsBadWritePtr( LPVOID ptr, UINT size )
 648 {
 649     if (!size) return FALSE;  /* handle 0 size case w/o reference */
 650     if (!ptr) return TRUE;
 651
 652     if (!page_size) page_size = getpagesize();
 653     __TRY
 654     {
 655         volatile char *p = ptr;
 656         UINT count = size;
 657
 658         while (count > page_size)
 659         {
 660             *p |= 0;
 661             p += page_size;
 662             count -= page_size;
 663         }
 664         p[0] |= 0;
 665         p[count - 1] |= 0;
 666     }
 667     __EXCEPT_PAGE_FAULT
 668     {
 669         TRACE_(seh)("%p caused page fault during write\n", ptr);
 670         return TRUE;
 671     }
 672     __ENDTRY
 673     return FALSE;
 674 }
 675
 676
 677 /***********************************************************************
 678  *             IsBadHugeReadPtr   (KERNEL32.@)
 679  *
 680  * Check for read access on a memory block.
 681  *
 682  * PARAMS
 683  *  ptr  [I] Address of memory block.
 684  *  size [I] Size of block.
 685  *
 686  * RETURNS
 687  *  Success: TRUE.
 688  *      Failure: FALSE. Process has read access to entire block.
 689  */
 690 BOOL WINAPI IsBadHugeReadPtr( LPCVOID ptr, UINT size )
 691 {
 692     return IsBadReadPtr( ptr, size );
 693 }
 694
 695
 696 /***********************************************************************
 697  *             IsBadHugeWritePtr   (KERNEL32.@)
 698  *
 699  * Check for write access on a memory block.
 700  *
 701  * PARAMS
 702  *  ptr  [I] Address of memory block.
 703  *  size [I] Size of block.
 704  *
 705  * RETURNS
 706  *  Success: TRUE.
 707  *      Failure: FALSE. Process has write access to entire block.
 708  */
 709 BOOL WINAPI IsBadHugeWritePtr( LPVOID ptr, UINT size )
 710 {
 711     return IsBadWritePtr( ptr, size );
 712 }
 713
 714
 715 /***********************************************************************
 716  *             IsBadCodePtr   (KERNEL32.@)
 717  *
 718  * Check for read access on a memory address.
 719  *
 720  * PARAMS
 721  *  ptr [I] Address of function.
 722  *
 723  * RETURNS
 724  *      Success: TRUE.
 725  *      Failure: FALSE. Process has read access to specified memory.
 726  */
 727 BOOL WINAPI IsBadCodePtr( FARPROC ptr )
 728 {
 729     return IsBadReadPtr( ptr, 1 );
 730 }
 731
 732
 733 /***********************************************************************
 734  *             IsBadStringPtrA   (KERNEL32.@)
 735  *
 736  * Check for read access on a range of memory pointed to by a string pointer.
 737  *
 738  * PARAMS
 739  *  str [I] Address of string.
 740  *  max [I] Maximum size of string.
 741  *
 742  * RETURNS
 743  *      Success: TRUE.
 744  *      Failure: FALSE. Read access to all bytes in string.
 745  */
 746 BOOL WINAPI IsBadStringPtrA( LPCSTR str, UINT max )
 747 {
 748     if (!str) return TRUE;
 749
 750     __TRY
 751     {
 752         volatile const char *p = str;
 753         while (p != str + max) if (!*p++) break;
 754     }
 755     __EXCEPT_PAGE_FAULT
 756     {
 757         TRACE_(seh)("%p caused page fault during read\n", str);
 758         return TRUE;
 759     }
 760     __ENDTRY
 761     return FALSE;
 762 }
 763
 764
 765 /***********************************************************************
 766  *             IsBadStringPtrW   (KERNEL32.@)
 767  *
 768  * See IsBadStringPtrA.
 769  */
 770 BOOL WINAPI IsBadStringPtrW( LPCWSTR str, UINT max )
 771 {
 772     if (!str) return TRUE;
 773
 774     __TRY
 775     {
 776         volatile const WCHAR *p = str;
 777         while (p != str + max) if (!*p++) break;
 778     }
 779     __EXCEPT_PAGE_FAULT
 780     {
 781         TRACE_(seh)("%p caused page fault during read\n", str);
 782         return TRUE;
 783     }
 784     __ENDTRY
 785     return FALSE;
 786 }