Searches for an existing shared memory object with the given name and returns its handle and virtual address.
HANDLE RtOpenSharedMemory(
DWORD dwDesiredAccess,
BOOLEAN bInheritHandle,
LPCTSTR lpName,
VOID ** location
);
Parameters
dwDesiredAccess
- Ignored.
bInheritHandle
- Ignored.
lpName
- Pointer to a null-terminated string that names the shared memory object to open. Name comparisons are case sensitive.
location
- Pointer to a pointer that receives the shared memory object's virtual address.
Return Values
- Handle to shared memory object
- Success.
- NULL
- Failure. For extended error information, see GetLastError.
Requirements
| Versions |
Defined in |
Include |
Link to |
| INtime 3.0 |
intime/rt/include/iwin32.h |
iwin32.h |
iwin32.lib |
Remarks
- This function operates in the real-time portion of your application.
- The iwin32x API also includes an RtOpenSharedMemory function that operates in the Windows portion of your application.
- Use RtUnmapSharedMemory to free the virtual memory associated with this call.
See Also
RtCreateSharedMemory, iwin32 API, iwin32 Overview
