RtOpenMutex

RtOpenMutex returns a handle to the named RTSS mutex.

Syntax

HANDLE RtOpenMutex(
    DWORD DesiredAccess,
    BOOL bInheritHandle,
    LPCTSTR lpName
);

Parameters

DesiredAccess

Ignored.

bInheritHandle

Ignored.

lpName

A pointer to a null-terminated string that names the mutex to be opened. Name comparisons are case-sensitive.

Return Value

A handle to the mutex object if the function succeeds, NULL if the function fails

To get extended error information, call GetLastError.

Remarks

RtOpenMutex enables multiple processes to open handles of the same mutex object. The function succeeds only if some process has already created the mutex with RtCreateMutex. The calling process can use the returned handle in any function that requires a handle of a mutex object, such as a wait function.

Use RtCloseHandle to close the handle. The system closes the handle automatically when the process terminates. The mutex object is destroyed when its last handle has been closed.

See Also:

RtCloseHandle

RtCreateMutex

RtReleaseMutex