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