Single-Instance-Anwendungen in Windows: Mutex, Named Pipes und Code-Beispiele

Das Single-Instance-Muster beschreibt eine Entwurfsentscheidung in der Windows-Anwendungsentwicklung: Eine Anwendung soll zu einem gegebenen Zeitpunkt nur in einer einzigen Instanz im System laufen. Versucht der Benutzer, die Anwendung ein zweites Mal zu öffnen, bringt die neue Instanz das bereits laufende Fenster in den Vordergrund und beendet sich selbst.

Dieses Verhalten ist für viele Desktop-Programme selbstverständlich: Mediaplayer, Notiz-Apps, Konfigurations-Tools – all diese Programme öffnen sich nicht doppelt, sondern wechseln zur laufenden Instanz.

Warum Single-Instance implementieren?

Die Gründe für das Single-Instance-Muster sind vielfältig:

• Datenkonsistenz – Zwei Instanzen, die dieselbe Datei oder Datenbank öffnen, können sich gegenseitig überschreiben
• Ressourcenschonung – Unnötige Prozesse verbrauchen RAM und CPU
• Benutzerfreundlichkeit – Der Anwender erwartet, zur laufenden Instanz geführt zu werden
• Lizenzkontrolle – Einige Anwendungen erlauben pro Gerät nur eine aktive Sitzung

Methode 1: Mutex (empfohlen)

Die Mutex-Methode (Mutual Exclusion Object) ist die zuverlässigste und am häufigsten verwendete Technik. Ein benannter Mutex ist systemweit sichtbar und kann von mehreren Prozessen gelesen werden.

C++ Implementierung:

#include <windows.h>

int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE, LPSTR, int nCmdShow) {
    HANDLE hMutex = CreateMutex(NULL, TRUE, L"Global\MyApp_SingleInstance");

    if (GetLastError() == ERROR_ALREADY_EXISTS) {
        // Instanz läuft bereits – Fenster in den Vordergrund holen
        HWND hWnd = FindWindow(NULL, L"Meine Anwendung");
        if (hWnd) {
            ShowWindow(hWnd, SW_RESTORE);
            SetForegroundWindow(hWnd);
        }
        CloseHandle(hMutex);
        return 0;
    }

    // Normale Initialisierung der Anwendung
    // ...

    CloseHandle(hMutex);
    return 0;
}

C# / .NET Implementierung:

using System.Threading;

static class Program {
    static void Main() {
        bool createdNew;
        using var mutex = new Mutex(true, "Global\MyApp_SingleInstance", out createdNew);

        if (!createdNew) {
            // Andere Instanz läuft bereits
            var hWnd = FindExistingWindow();
            if (hWnd != IntPtr.Zero) {
                ShowWindow(hWnd, SW_RESTORE);
                SetForegroundWindow(hWnd);
            }
            return;
        }

        Application.Run(new MainForm());
    }
}

Methode 2: Named Pipe mit Datenübergabe

Named Pipes ermöglichen nicht nur die Erkennung einer laufenden Instanz, sondern auch die Übergabe von Kommandozeilenargumenten an diese Instanz. Das ist besonders nützlich, wenn die zweite Instanz eine Datei öffnen soll, die die erste Instanz dann lädt.

// Prüfen, ob Named Pipe bereits existiert
HANDLE hPipe = CreateFile(
    L"\\.\pipe\MyApp_Pipe",
    GENERIC_WRITE, 0, NULL,
    OPEN_EXISTING, 0, NULL
);

if (hPipe != INVALID_HANDLE_VALUE) {
    // Instanz läuft – Argumente senden
    DWORD written;
    WriteFile(hPipe, commandLine, strlen(commandLine), &written, NULL);
    CloseHandle(hPipe);
    return 0;
}

// Pipe erstellen und auf Verbindungen warten (Serverseite)
HANDLE hServer = CreateNamedPipe(
    L"\\.\pipe\MyApp_Pipe",
    PIPE_ACCESS_INBOUND,
    PIPE_TYPE_BYTE | PIPE_WAIT,
    1, 256, 256, 0, NULL
);

Methode 3: FindWindow (vereinfacht)

Die einfachste, aber auch unzuverlässigste Methode sucht nach einem Fenster mit einem bekannten Klassennamen:

HWND hWnd = FindWindow(L"MyAppWindowClass", NULL);
if (hWnd != NULL) {
    SetForegroundWindow(hWnd);
    return 0;
}

Diese Methode scheitert, wenn der Fenstername lokalisiert wurde oder kein Fenster angezeigt wird (Tray-Anwendungen).

Vergleich der Methoden

Häufig gestellte Fragen