CancelDC-Funktion (wingdi.h)
Die CancelDC-Funktion bricht alle ausstehenden Vorgänge für den angegebenen Gerätekontext (Device Context, DC) ab.
Syntax
BOOL CancelDC(
[in] HDC hdc
);
Parameter
[in] hdc
Ein Handle für den DC.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.
Hinweise
Die CancelDC-Funktion wird von Multithreadanwendungen verwendet, um lange Zeichnungsvorgänge abzubrechen. Wenn Thread A einen langwierigen Zeichnungsvorgang initiiert, kann Thread B diesen Vorgang abbrechen, indem er diese Funktion aufruft.
Wenn ein Vorgang abgebrochen wird, gibt der betroffene Thread einen Fehler zurück, und das Ergebnis des Zeichnungsvorgangs ist nicht definiert. Die Ergebnisse sind auch nicht definiert, wenn beim Aufrufen der Funktion kein Zeichnungsvorgang ausgeführt wurde.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | wingdi.h (windows.h einschließen) |
| Bibliothek | Gdi32.lib |
| DLL | Gdi32.dll |