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);
}