Använda namngivna objekt

I följande exempel visas användningen av objektnamn genom att skapa och öppna en namngiven mutex.

Första processen

Den första processen använder funktionen CreateMutex för att skapa mutex-objektet. Observera att den här funktionen lyckas även om det finns ett befintligt objekt med samma namn.

#include <windows.h>
#include <stdio.h>
#include <conio.h>

// This process creates the mutex object.

int main(void)
{
    HANDLE hMutex; 

    hMutex = CreateMutex( 
        NULL,                        // default security descriptor
        FALSE,                       // mutex not owned
        TEXT("NameOfMutexObject"));  // object name

    if (hMutex == NULL) 
        printf("CreateMutex error: %d\n", GetLastError() ); 
    else 
        if ( GetLastError() == ERROR_ALREADY_EXISTS ) 
            printf("CreateMutex opened an existing mutex\n"); 
        else printf("CreateMutex created a new mutex.\n");

    // Keep this process around until the second process is run
    _getch();

    CloseHandle(hMutex);

    return 0;
}

Andra processen

Den andra processen använder funktionen OpenMutex för att öppna ett handtag till den befintliga mutexen. Den här funktionen misslyckas om ett mutex-objekt med det angivna namnet inte finns. Åtkomstparametern begär fullständig åtkomst till mutex-objektet, vilket är nödvändigt för att handtaget ska kunna användas i någon av väntefunktionerna.

#include <windows.h>
#include <stdio.h>

// This process opens a handle to a mutex created by another process.

int main(void)
{
    HANDLE hMutex; 

    hMutex = OpenMutex( 
        MUTEX_ALL_ACCESS,            // request full access
        FALSE,                       // handle not inheritable
        TEXT("NameOfMutexObject"));  // object name

    if (hMutex == NULL) 
        printf("OpenMutex error: %d\n", GetLastError() );
    else printf("OpenMutex successfully opened the mutex.\n");

    CloseHandle(hMutex);

    return 0;
}

objektnamn

Använda Mutex-objekt