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

Note

• 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.

See Also

RtCreateSharedMemory, iwin32 API, iwin32 Overview