Searches for an existing mutex with the given name and returns its handle.

HANDLE RtOpenMutex(
    DWORD dwDesiredAccess,
    BOOLEAN bInheritHandle,
    LPCTSTR lpName
);

Parameters

dwDesiredAccess

Ignored.

bInheritHandle

Ignored.

lpName

Pointer to a null-terminated string that names the mutex to open. Name comparisons are case-sensitive.

Remarks

RtOpenMutex can also be used from a Windows application to obtain the handle of an iWin32 mutex.

Return Values

A handle to the mutex object

Success.

NULL

Failure. For extended error information, see the Windows' GetLastError function.

Requirements

Notes

• This function operates in the Windows portion of your application.
• The iwin32 API also includes an RtOpenMutex function that operates in the real-time portion of your application.

See Also

iwin32x API, iwin32 Overview