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

Weitere Informationen

CreateThread

Gerätekontextfunktionen

Übersicht über Gerätekontexte

GetCurrentThread