2.1.19.7 GlobalLock

1 Description
2 Syntax
3 Parameters
4 Return
5 Examples
6 Remark
7 See Also
8 Header to Include
9 Reference

Description

The GlobalLock function locks a global memory object and returns a pointer to the first byte of the object's memory block.

Syntax

LPVOID GlobalLock( HGLOBAL hMem )

Parameters

hMem: [input] Handle to the global memory object.

Return

If the function succeeds, the return value is a pointer to the first byte of the memory block.

If the function fails, the return value is NULL.

Examples

EX1

void GlobalLock_Ex1()
{
	int nBytes = 200; 
	HGLOBAL hData = GlobalAlloc(GHND,nBytes);
	
	char* pstr = (char *)GlobalLock(hData) ;
		

	if(NULL==pstr)
	{
		out_str("failed to Lock the memory\n");
		return ;
	}
	else
		printf("the first byte of the object's memory address: (0x)%x",pstr);

	GlobalUnlock(hData);
	
  	GlobalFree(hData);
}