INtime SDK Help
OpenMutex, RtOpenMutex (iwin32)
INtime SDK v6 > About INtime > Alternate APIs > iwin32 API > iwin32 API > OpenMutex, RtOpenMutex (iwin32)

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

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

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

Requirements

Versions Defined in Include Link to
INtime 3.0 intime/rt/include/iwin32.h
intime/rt/include/winbase.h
iwin32.h
windows.h
iwin32.lib

Notes

See Also

CloseHandle, CreateEvent, CreateMutex, ReleaseMutex, iwin32 API, iwin32 Overview