LocalLock

Syntax

PSTR LocalLock(hMem)

This function locks the local memory block specified by the hMem parameter. The block is locked into memory at the given address and its reference count is increased by one. Locked memory cannot be moved or discarded. The block remains locked in memory until its reference count is decreased to zero by using the LocalUnlock function.

Parameter

Type/Description

hMem

HANDLE Identifies the local memory block to be locked.

Return Value

The return value points to the first byte of memory in the local block if the function is successful. Otherwise, it is NULL.