ReceiveTempSMS
/
Sweden-Number
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

kernel: Update WARN/ERR and documentation for GlobalLock/GlobalUnlock.

This commit is contained in:
Detlef Riekenberg 2006-04-14 09:57:19 +02:00 committed by Alexandre Julliard
parent 0705381069
commit f64f9ef5fa
1 changed files with 26 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

41
dlls/kernel/heap.c
View File

@ -392,15 +392,20 @@ HGLOBAL WINAPI GlobalAlloc(
/*********************************************************************** /***********************************************************************
* GlobalLock (KERNEL32.@) * GlobalLock (KERNEL32.@)
* *
* Lock a global memory object. * Lock a global memory object and return a pointer to first byte of the memory
*
* PARAMS
* hmem [I] Handle of the global memory object
* *
* RETURNS * RETURNS
* Pointer to first byte of block * Success: Pointer to first byte of the memory block
* NULL: Failure * Failure: NULL
*
* NOTES
* When the handle is invalid, last error is set to ERROR_INVALID_HANDLE
*
*/ */
LPVOID WINAPI GlobalLock( LPVOID WINAPI GlobalLock(HGLOBAL hmem)
HGLOBAL hmem /* [in] Handle of global memory object */
)
{ {
PGLOBAL32_INTERN pintern; PGLOBAL32_INTERN pintern;
LPVOID palloc; LPVOID palloc;
@ -422,14 +427,14 @@ LPVOID WINAPI GlobalLock(
} }
else else
{ {
WARN("invalid handle %p\n", hmem); WARN("invalid handle %p (Magic: 0x%04x)\n", hmem, pintern->Magic);
palloc = NULL; palloc = NULL;
SetLastError(ERROR_INVALID_HANDLE); SetLastError(ERROR_INVALID_HANDLE);
} }
} }
__EXCEPT_PAGE_FAULT __EXCEPT_PAGE_FAULT
{ {
WARN("page fault on %p\n", hmem); WARN("(%p): Page fault occurred ! Caused by bug ?\n", hmem);
palloc = NULL; palloc = NULL;
SetLastError(ERROR_INVALID_HANDLE); SetLastError(ERROR_INVALID_HANDLE);
} }
@ -444,13 +449,19 @@ LPVOID WINAPI GlobalLock(
* *
* Unlock a global memory object. * Unlock a global memory object.
* *
* PARAMS
* hmem [I] Handle of the global memory object
*
* RETURNS * RETURNS
* TRUE: Object is still locked * Success: Object is still locked
* FALSE: Object is unlocked * Failure: FALSE (The Object is unlocked)
*
* NOTES
* When the handle is invalid, last error is set to ERROR_INVALID_HANDLE
*
*/ */
BOOL WINAPI GlobalUnlock( BOOL WINAPI GlobalUnlock(HGLOBAL hmem)
HGLOBAL hmem /* [in] Handle of global memory object */ {
) {
PGLOBAL32_INTERN pintern; PGLOBAL32_INTERN pintern;
BOOL locked; BOOL locked;
@ -477,14 +488,14 @@ BOOL WINAPI GlobalUnlock(
} }
else else
{ {
WARN("invalid handle\n"); WARN("invalid handle %p (Magic: 0x%04x)\n", hmem, pintern->Magic);
SetLastError(ERROR_INVALID_HANDLE); SetLastError(ERROR_INVALID_HANDLE);
locked=FALSE; locked=FALSE;
} }
} }
__EXCEPT_PAGE_FAULT __EXCEPT_PAGE_FAULT
{ {
ERR("page fault occurred ! Caused by bug ?\n"); WARN("(%p): Page fault occurred ! Caused by bug ?\n", hmem);
SetLastError( ERROR_INVALID_PARAMETER ); SetLastError( ERROR_INVALID_PARAMETER );
locked=FALSE; locked=FALSE;
} }