API -> CreateMutex [ Library : kernel32.dll, Category : Mutex ] [C#, VB, VB.net]

CreateMutex

Library : kernel32.dll Category : Mutex

Api Example(s)
This is a link to different site Calling Win32 DLLs in C# with P/Invoke
Registering File Associations and Passing Command Line Parameters to an Existing App Instance
Handling NTFS Permissions Part -1 (handling kernel object permissions)

API Description :

The CreateMutex function creates a named or unnamed mutex object.

VB Declaration :

Show Multiline Public Private

Declare Function CreateMutex Lib "kernel32" Alias "CreateMutexA" (lpMutexAttributes As SECURITY_ATTRIBUTES, ByVal bInitialOwner As Long, ByVal lpName As String) As Long

Parameters :

· lpMutexAttributes
Pointer to a SECURITY_ATTRIBUTES structure that determines whether the returned handle can be inherited by child processes. If lpMutexAttributes is NULL, the handle cannot be inherited.
Windows NT: The lpSecurityDescriptor member of

Return :

If the function succeeds, the return value is a handle to the mutex object. If the named mutex object existed before the function call, the GetLastError function returns ERROR_ALREADY_EXISTS. Otherwise, GetLastError returns zero. 

If the function fails

OS Requirement :

Requires Windows NT 3.1 or later
Requires Windows 95 or later

Dotnet Replacement :

System.Threading.Mutex constructor