SHLockShared function (shlwapi.h)

[SHLockShared is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]

Maps a block of memory from a specified process into the calling process.

Syntax

void * SHLockShared(
  [in] HANDLE hData,
  [in] DWORD  dwProcessId
);

Parameters

[in] hData

Type: HANDLE

A handle to the memory you want to map into the calling process.

[in] dwProcessId

Type: DWORD

The process ID of the process from which you want to map the block of memory.

Return value

Returns a void pointer to the shared memory. Returns NULL if unsuccessful.

Remarks

Call SHUnlockShared to unlock the memory that this function maps. Call SHFreeShared to release the memory.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header shlwapi.h
DLL Shlwapi.dll