Edit

Share via


CancelDC function (wingdi.h)

The CancelDC function cancels any pending operation on the specified device context (DC).

Syntax

BOOL CancelDC(
  [in] HDC hdc
);

Parameters

[in] hdc

A handle to the DC.

Return value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero.

Remarks

The CancelDC function is used by multithreaded applications to cancel lengthy drawing operations. If thread A initiates a lengthy drawing operation, thread B may cancel that operation by calling this function.

If an operation is canceled, the affected thread returns an error and the result of its drawing operation is undefined. The results are also undefined if no drawing operation was in progress when the function was called.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header wingdi.h (include Windows.h)
Library Gdi32.lib
DLL Gdi32.dll

See also

CreateThread

Device Context Functions

Device Contexts Overview

GetCurrentThread