SHAllocShared function
[SHAllocShared is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]
Allocates a handle in a specified process to a copy of a specified memory block in the calling process.
Syntax
HANDLE SHAllocShared( _In_opt_ const void *pvData, _In_ DWORD dwSize, _In_ DWORD dwDestinationProcessId );
Parameters
- pvData [in, optional]
-
Type: const void*
A pointer to the memory block in the calling process that is to be copied. You can set this parameter to NULL if you want to share a block of memory without copying any data to it.
- dwSize [in]
-
Type: DWORD
The size, in bytes, of the memory block pointed to by pvData.
- dwDestinationProcessId [in]
-
Type: DWORD
The process ID of the process that will share memory block specified by pvData.
Return value
Type: HANDLE
Returns a handle to the shared memory for the process specified by dwDestinationProcessId. Returns NULL if unsuccessful.
Remarks
Use SHFreeShared to free the handle when you are finished.
Requirements
|
Minimum supported client |
Windows XP [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows Server 2003 [desktop apps only] |
|
End of client support |
Windows XP with SP2 |
|
End of server support |
Windows Server 2003 |
|
Header |
|
|
DLL |
|
See also