The following examples illustrate the use of object names by creating and opening named objects.
Mutex
The first process uses the CreateMutex function to create the mutex object. Note that the function succeeds even if there is an existing object with the same name.
// One process creates the mutex object.
HANDLE hMutex;
DWORD dwErr;
hMutex = CreateMutex(
NULL, // no security descriptor
FALSE, // mutex not owned
"NameOfMutexObject"); // object name
if (hMutex == NULL)
printf("CreateMutex error: %d\n", GetLastError() );
else
if ( GetLastError() == ERROR_ALREADY_EXISTS )
printf("CreateMutex opened existing mutex\n");
else
printf("CreateMutex created new mutex\n");
The second process uses the OpenMutex function to open a handle of the existing mutex. This function fails if a mutex object with the specified name does not exist. The access parameter requests full access to the mutex object, which is necessary for the handle to be used in any of the wait functions.
// Another process opens a handle of the existing mutex.
HANDLE hMutex;
hMutex = OpenMutex(
MUTEX_ALL_ACCESS, // request full access
FALSE, // handle not inheritable
"NameOfMutexObject"); // object name
if (hMutex == NULL)
printf("OpenMutex error: %d\n", GetLastError() );
Semaphore
The following example uses the CreateSemaphore function to illustrate a named-object creation operation that fails if the object already exists.
HANDLE CreateNewSemaphore(LPSECURITY_ATTRIBUTES lpsa,
LONG cInitial, LONG cMax, LPTSTR lpszName)
{
HANDLE hSem;
// Create or open a named semaphore.
hSem = CreateSemaphore(
lpsa, // security attributes
cInitial, // initial count
cMax, // maximum count
lpszName); // semaphore name
// Close handle, and return NULL if existing semaphore opened.
if (hSem != NULL && GetLastError() == ERROR_ALREADY_EXISTS)
{
CloseHandle(hSem);
return NULL;
}
// If new semaphore was created, return the handle.
return hSem;
}