MutEx

=Allowing only one instance of your program=
//[[user:StPendl|1304860064]]//
[[toc]]
----
==The Basics==
Every now and then one wants to make sure that only one instance of his application is running to prevent problems with shared resources when multiple instances are run concurrently.

This is called **mut**ually **ex**clusive access, in short Mut-Ex or Mutex.

MSDN has a nice article about [[@http://msdn.microsoft.com/en-us/library/ms684266(VS.85).aspx|Mutex Objects]], which you should read to get a general understanding of the subject.

==The API functions involved==
===The CreateMutex function===
The first function is the one we use to create a mutext, which is the [[@http://msdn.microsoft.com/en-us/library/ms682411(VS.85).aspx|CreateMutex Function]]
It receives the security attributes, initial owner and name of our mutex object to create.

We do not want to grant other processes or threads access to our mutex, so we use NULL for the security attributes.
We want to be the initial owner of the mutex to prevent subsequent instances of our program to be run, so we set that to TRUE = 1.
We select a unique name for our mutex to have it easily separated from other mutex objects.

Here is the code to do all of this.
[[code format="lb"]]
    ' inherit the default security attributes
    lpMutexAttributes = _NULL

    ' optain initial ownership by setting this to 1
    bInitialOwner = 1

    ' use a unique name for the mutex
    lpName$ = "LBMutExDemo"

    calldll #kernel32, "CreateMutexA",_
        lpMutexAttributes as ulong,_
        bInitialOwner     as long, _
        lpName$           as ptr,_
        hMutex            as ulong
[[code]]

===The GetLastError function===
The first function is the one we use to create a mutext, which is the [[@http://msdn.microsoft.com/en-us/library/ms679360(VS.85).aspx|GetLastError Function]]
It receives the security attributes, initial owner and name of our mutex object to create.

We do not want to grant other processes or threads access to our mutex, so we use NULL for the security attributes.
We want to be the initial owner of the mutex to prevent subsequent instances of our program to be run, so we set that to TRUE = 1.
We select a unique name for our mutex to have it easily separated from other mutex objects.

Here is the code to do all of this.
[[code format="lb"]]
    ' inherit the default security attributes
    lpMutexAttributes = _NULL

    ' optain initial ownership by setting this to 1
    bInitialOwner = 1

    ' use a unique name for the mutex
    lpName$ = "LBMutExDemo"

    calldll #kernel32, "CreateMutexA",_
        lpMutexAttributes as ulong,_
        bInitialOwner     as long, _
        lpName$           as ptr,_
        hMutex            as ulong
[[code]]
==Third Part Title==
Text here.
[[code format="lb"]]
'code here
[[code]]